Skip to main content
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.
LayerWhat it does
AgentThe execution loop. Model calls, tool orchestration, structured outputs, context management, middleware, and tracing
CapabilitiesTools, knowledge (RAG), memory, skills, guardrails, security, evaluation
InterfacesDeploy agents to Telegram, Discord, Slack, WhatsApp, email, voice calls, WebSocket, or custom platforms
RuntimeHTTP endpoints, cron scheduling, webhooks, multi-interface serving, and hot-reload dev mode

What You Can Build

agent.py
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 Build and run an agent with tools in under 20 lines of code.
  • Agents The core execution loop: models, tools, and instructions.
  • Teams Coordinate multiple agents to collaborate, route, or divide work.
  • Workflows Orchestrate agents through sequential, parallel, conditional, and iterative steps.
  • Models 10 providers, string shorthand, streaming, structured output, vision, and audio.
  • Knowledge 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.