mkdocs.yml

site_name: Agentomatic
site_description: Drop agents, not code — Zero-code multi-agent API platform framework
site_author: UnicoLab
site_url: https://unicolab.github.io/agentomatic
repo_url: https://github.com/UnicoLab/agentomatic
repo_name: UnicoLab/agentomatic
edit_uri: edit/main/docs/
copyright: Copyright © 2024-2026 UnicoLab

theme:
  name: material
  custom_dir: docs/overrides
  logo: assets/agentomatic-mark.svg
  favicon: assets/agentomatic-mark.svg
  font:
    text: Inter
    code: JetBrains Mono
  palette:
    - media: "(prefers-color-scheme: dark)"
      scheme: slate
      primary: deep purple
      accent: pink
      toggle:
        icon: material/brightness-7
        name: Switch to light mode
    - media: "(prefers-color-scheme: light)"
      scheme: default
      primary: deep purple
      accent: pink
      toggle:
        icon: material/brightness-4
        name: Switch to dark mode
  features:
    - announce.dismiss
    - navigation.instant
    - navigation.instant.progress
    - navigation.tracking
    - navigation.tabs
    - navigation.tabs.sticky
    - navigation.sections
    - navigation.expand
    - navigation.indexes
    - navigation.top
    - navigation.footer
    - navigation.path
    - search.suggest
    - search.highlight
    - search.share
    - content.tabs.link
    - content.code.copy
    - content.code.annotate
    - content.action.edit
    - content.action.view
    - content.footnote.tooltips
    - content.tooltips
    - toc.follow
  icon:
    repo: fontawesome/brands/github

plugins:
  - search
  - mike:
      alias_type: symlink
      canonical_version: latest

extra_css:
  - stylesheets/extra.css

markdown_extensions:
  - pymdownx.highlight:
      anchor_linenums: true
      line_spans: __span
      pygments_lang_class: true
  - pymdownx.inlinehilite
  - pymdownx.superfences:
      custom_fences:
        - name: mermaid
          class: mermaid
          format: !!python/name:pymdownx.superfences.fence_code_format
  - pymdownx.tabbed:
      alternate_style: true
      slugify: !!python/object/apply:pymdownx.slugs.slugify
        kwds:
          case: lower
  - pymdownx.details
  - pymdownx.snippets
  - pymdownx.mark
  - pymdownx.keys
  - pymdownx.smartsymbols
  - admonition
  - attr_list
  - md_in_html
  - def_list
  - footnotes
  - abbr
  - toc:
      permalink: true
      toc_depth: 3
  - pymdownx.emoji:
      emoji_index: !!python/name:material.extensions.emoji.twemoji
      emoji_generator: !!python/name:material.extensions.emoji.to_svg
  - pymdownx.tasklist:
      custom_checkbox: true

extra:
  version:
    provider: mike
  social:
    - icon: fontawesome/brands/github
      link: https://github.com/UnicoLab/agentomatic
      name: Agentomatic on GitHub
    - icon: fontawesome/brands/python
      link: https://pypi.org/project/agentomatic/
      name: Agentomatic on PyPI
  generator: false

nav:
  - Home: index.md
  - Getting Started:
    - Installation: getting-started/installation.md
    - Concepts & Glossary: getting-started/concepts.md
    - Quick Start: getting-started/quickstart.md
    - Your First Agent: getting-started/first-agent.md
  - User Guide:
    - Class-Based Agents: guide/class-agents.md
    - Agent Structure & Discovery: guide/agent-structure.md
    - Cookbook & Recipes: guide/cookbook.md
    - Templates: guide/templates.md
    - Input & Output Schemas: guide/schemas.md
    - Prompt Management: guide/prompts.md
    - Configuration: guide/configuration.md
    - Storage Backends: guide/storage.md
    - Middleware: guide/middleware.md
    - LangGraph Integration: guide/langgraph.md
    - LangChain Adapter: guide/langchain-adapter.md
    - ML Plugins: guide/ml-plugins.md
    - Testing Your Agents: guide/testing.md
  - Optimization:
    - Overview: optimization/index.md
    - How It Works: optimization/how-it-works.md
    - Metrics, Judges & Loss: optimization/metrics.md
    - Generalization & Overfitting: optimization/generalization.md
    - Datasets & Augmentation: optimization/data.md
    - Class Agents (compile / fit): optimization/class-agents.md
    - Low Level (PromptFitter): optimization/prompt-fitter.md
    - Reports: optimization/reports.md
    - CLI & Legacy API: optimization/cli.md
    - Examples: optimization/examples.md
    - Prompt Optimization (moved): guide/optimization.md
  - Advanced:
    - Production Deployment: guide/deployment.md
    - Verifying a Deployment: guide/verifying-a-deployment.md
    - Platform Features: guide/platform-features.md
    - Custom Endpoints: guide/endpoints.md
    - Tasks & Execution Modes: guide/tasks.md
    - Status Dashboard: guide/status.md
    - Ingestion & RAG: guide/ingestion.md
    - Per-Agent Connections: guide/connections.md
    - Custom DB & Vector Connections: guide/custom-connections.md
    - Observability & Monitoring: guide/observability.md
    - Telemetry & Feedback: guide/telemetry.md
    - Pipelines: guide/pipelines.md
    - Configuration Stacks: guide/stacks.md
    - LLM Providers & Failover: guide/llm-providers.md
    - Security & Zero Trust: guide/security.md
    - Production Control Plane: guide/control-plane.md
    - Swarm Delegation: guide/delegation.md
  - Debugging:
    - Agentomatic Studio: guide/studio.md
    - Deep Agent Integration: guide/deep-agents.md
    - Chat Interface (Chainlit): guide/debug-ui.md
    - Demo Command: guide/demo.md
  - CLI Reference:
    - Commands: cli/commands.md
  - Architecture:
    - Overview: architecture/overview.md
    - API Reference: architecture/api-reference.md
    - Frontend API Guide: FRONTEND_API_GUIDE.md
  - Contributing: contributing.md
  - Changelog: changelog.md