Build production AI without the rewrite.

An open-source Python framework for agents and workflows. Typed, streaming, zero cold starts.

Start building

View on GitHub

from timbal import Agent
from timbal.tools import WebSearch
 
agent = Agent(
    name="assistant",
    model="anthropic/claude-sonnet-4-6",
    tools=[WebSearch()],
)
 
result = await agent(prompt="...").collect()

Any model, one API key.

OpenAI, Anthropic, Google, Groq or your own weights. Chain them and fall over mid-stream when one fails.

Pause for a human.

A gate step pauses the run. Resume later, from any process.

Evals that test the path.

Assert on the output, the timing, the tokens, each tool call and the flow itself.

from timbal import Agent
from timbal.tools import WebSearch
 
agent = Agent(
    name="assistant",
    model="anthropic/claude-sonnet-4-6",
    tools=[WebSearch()],
)
 
result = await agent(prompt="...").collect()

Behaviour, enforced.

A runtime in front of any LLM provider. Same input, same path, every time.

Drop in by changing one line.

Point your OpenAI or Anthropic SDK at ACE. Same code, same parameters.

Rules, not prompts.

Schemas, guards and refusals as enforceable rules. Steer small models like big ones.

from openai import OpenAI
 
client = OpenAI(
    base_url="https://api.timbal.ai/ace/{uid}/v1",
    api_key="sk-...",
)
 
response = client.chat.completions.create(
    model="gpt-4o-mini",
    messages=[{"role": "user", "content": "refund this order"}],
)

Query documents like tables.

Upload PDFs, docs and transcripts. Vector, full-text and SQL share one query plan.

Vector, full-text, hybrid.

Semantic retrieval and BM25 ranking, joined to your structured tables.

SELECT d.id, d.title, c.plan, v.distance
FROM vector_search(
  "docs", "how do I cancel my subscription", k => 20
) v
JOIN docs d ON d.id = v.id
JOIN customers c ON c.id = d.customer_id
WHERE c.plan = "enterprise"
ORDER BY v.distance ASC
LIMIT 10;

Command line.

Scaffold, run locally and push when ready. No Docker.

TypeScript SDK.

Your workforce and knowledge bases from React, Node or Bun.

MCP.

Cursor, Claude or ChatGPT see your workforce and knowledge bases.

curl -fsSL https://timbal.ai/install.sh | sh
timbal new my-agent && timbal run

Ship AI applications. Agents and workflows, one workforce.

Quickstart

Star on GitHub