> ## Documentation Index
> Fetch the complete documentation index at: https://docs.definable.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Definable

> Build, run, and deploy AI agents with models, tools, knowledge, and memory.

Definable is a production-grade Python framework for building AI agents. It gives you composable primitives — models, tools, knowledge, memory, guardrails — and an execution engine that orchestrates them into reliable agentic systems.

| Layer            | What it does                                                                                                         |
| ---------------- | -------------------------------------------------------------------------------------------------------------------- |
| **Agent**        | The execution loop. Model calls, tool orchestration, structured outputs, context management, middleware, and tracing |
| **Capabilities** | Tools, knowledge (RAG), memory, skills, guardrails, security, evaluation                                             |
| **Interfaces**   | Deploy agents to Telegram, Discord, Slack, WhatsApp, email, voice calls, WebSocket, or custom platforms              |
| **Runtime**      | HTTP endpoints, cron scheduling, webhooks, multi-interface serving, and hot-reload dev mode                          |

## What You Can Build

```python agent.py theme={null}
from definable.agent import Agent
from definable.tool.decorator import tool

@tool
def search_web(query: str) -> str:
    """Search the web for information."""
    return f"Results for: {query}"

agent = Agent(
    model="gpt-4o",
    tools=[search_web],
    instructions="You are a research assistant.",
)

result = agent.run("What are the latest developments in quantum computing?")
print(result.content)
```

Single agents. Coordinated teams. Structured workflows. All built on one architecture.

## Start Building

* **[Your First Agent](/first-agent)** Build and run an agent with tools in under 20 lines of code.
* **[Agents](/agents/overview)** The core execution loop: models, tools, and instructions.
* **[Teams](/teams/overview)** Coordinate multiple agents to collaborate, route, or divide work.
* **[Workflows](/workflows/overview)** Orchestrate agents through sequential, parallel, conditional, and iterative steps.
* **[Models](/models/overview)** 10 providers, string shorthand, streaming, structured output, vision, and audio.
* **[Knowledge](/knowledge/overview)** Full RAG pipeline: readers, chunkers, embedders, rerankers, vector databases.

## Built for Production

* Async-first with sync wrappers for every API.
* 10 LLM providers with automatic key rotation and failover.
* Token counting, cost tracking, and usage analytics.
* Input/output/tool guardrails and security hardening.
* Native tracing with JSONL and debug exporters.
* Full type annotations with `py.typed` marker for mypy consumers.

***

**AI agents require composable architecture.** Definable is the framework for building it.