This release is a pre-release and may not be stable for production use.
10xGraph
Write your AI logic. 10xGraph runs the infrastructure.
10xGraph is open-source, self-hosted infrastructure for AI applications. You write the agents, tools and tasks; 10xGraph runs them behind an API server with authentication, role-based access, tenant isolation, durable state in Postgres and Redis, background jobs, metrics and tracing, and generates Docker and Kubernetes deploy files. MIT licensed, by 10xScale. Formerly Agentflow.
This repository is the core library of that infrastructure (PyPI 10xgraph, import tenxgraph). The API server is 10xgraph-api and the TypeScript client is 10xgraph-client. Together they are one stack. Docs: 10xgraph.com.
What this package gives you
- Graph engine. Build workflows as a
StateGraphof nodes, tools and conditional edges, or start from prebuilt agents. Multi-agent patterns (swarm, supervisor team, handoff) are included as features. State graph, prebuilt agents - Durable state and checkpointing.
PgCheckpointerkeeps threads in Postgres with Redis as a hot cache and versioned compare-and-swap writes, so two runs on one thread cannot overwrite each other.SqliteCheckpointerandInMemoryCheckpointercover local work. Checkpointing and threads - Tenant columns and row-level security. Declare
tenant_columnsandextra_columnson the checkpointer and store. They become real indexed columns, filled from the verified identity inconfig["user"], never from client input. Native Postgres row-level security is opt-in. Multi-tenant data, tenancy and access - Long-term memory.
PgVectorStorekeeps memory and RAG in the same Postgres (similarity, full-text or hybrid search).QdrantStoreis there if you want a dedicated vector service. Use PgVectorStore, memory and store - Replay-safe tools. The run loop persists the current node before running it. Before a tool runs, the checkpointer's tool ledger is checked, and each completed call is recorded as soon as it returns, so a tool that already ran is not executed again on resume. Requires a checkpointer. Limit: a crash before a tool returns, or in the short gap before its record is written, can repeat the tool, so send an idempotency key derived from stable inputs for side effects like payments. Replay-safe tools, limits
- Tools and MCP. Plain Python functions as tools, run in parallel, with dependency injection through InjectQ and native Model Context Protocol support. Remote tools run in the user's browser or client.
interrupt()pauses a run for human approval. Use MCP, remote tools, human approval - Timeouts and graceful shutdown. Set
node_timeoutandtool_timeoutin the run config (no limit unless you set them).aclose()refuses new runs, lets active runs finish or saves them as interrupted. Graceful shutdown - Publishers and tracing. Events to Kafka, Redis Pub/Sub, RabbitMQ and OpenTelemetry; tracing to Logfire, LangSmith, Phoenix or any OTLP endpoint. Publishers, Phoenix, Logfire and LangSmith, OTLP
- Evaluation and testing. An eval framework (LLM-as-judge, trajectory matching, rubrics, user simulation, JSON, HTML and JUnit reports) and
TestAgentwith mocks for unit tests without live LLM calls. Testing and evaluation - Any model. OpenAI and OpenAI-compatible endpoints, Google Gemini (including Vertex AI), Anthropic (direct, Vertex AI or Bedrock). Changing the model string does not change the graph or the tools. No LangChain dependency.
- Also included: structured output, skills (Agent Skills spec), streaming, realtime audio over Gemini Live, multimodal media handling.
Install
pip install 10xgraph
Provider SDKs and infrastructure integrations are optional extras. Install only what you use:
| Extra | Adds |
|---|---|
google-genai, openai, anthropic |
Provider SDK adapters |
anthropic-vertex, anthropic-bedrock |
Claude on Vertex AI or Amazon Bedrock |
realtime |
Audio-to-audio agents over Gemini Live |
mcp |
Model Context Protocol client and tools |
pg_checkpoint, sqlite_checkpoint |
Durable checkpointing (Postgres + Redis, or SQLite) |
pgvector, qdrant |
Long-term memory store (Postgres pgvector, or Qdrant) |
redis, kafka, rabbitmq, all_publishers |
Event publishers |
otel, logfire, langsmith, phoenix, otlp, observability |
Tracing and OpenTelemetry export |
images, cloud-storage |
Multimodal media handling and offload |
all |
Every extra at once, for development and CI |
pip install "10xgraph[openai,pg_checkpoint,pgvector]"
To serve your graph over HTTP with auth, jobs, metrics and deploy files, add the server package:
pip install 10xgraph-api
Set your provider key; a .env file in the working directory is loaded automatically:
export GEMINI_API_KEY=... # Google Gemini
export OPENAI_API_KEY=sk-... # OpenAI, or any OpenAI-compatible endpoint
export ANTHROPIC_API_KEY=sk-... # Anthropic Claude
Requires Python 3.12 or newer. Tested on 3.12, 3.13, 3.14 and 3.15. Full guide: installation.
Quick start: a support agent with durable state
lookup_order reads data. refund_order moves money, so it must run once per request. Compiled with a checkpointer, a completed tool call is recorded and not re-run after a crash or retry.
# graph/agent.py
from tenxgraph.prebuilt.agent import ReactAgent
from tenxgraph.storage.checkpointer import PgCheckpointer
def lookup_order(order_id: str) -> dict:
"""Look up an order by id and return its status and total."""
return {"order_id": order_id, "status": "delivered", "total": 59.0}
def refund_order(order_id: str, amount: float) -> str:
"""Refund an order. This moves money, so it must run once per request."""
return f"Refunded {amount:.2f} for order {order_id}"
checkpointer = PgCheckpointer(postgres_dsn="postgresql://...", redis_url="redis://...")
app = ReactAgent(
model="claude-sonnet-5-5",
tools=[lookup_order, refund_order],
).compile(checkpointer=checkpointer)
Call it directly from Python:
from tenxgraph.core.state import Message
result = app.invoke(
{"messages": [Message.text_message("Order A-1001 arrived broken, please refund it.")]},
config={"thread_id": "1"},
)
Swap ReactAgent for RAGAgent, SwarmAgent, SupervisorTeamAgent or PlanActReflectAgent and the shape stays the same. For local work use InMemoryCheckpointer or SqliteCheckpointer instead of Postgres.
Serve it with 10xgraph dev
Point a config file at the compiled graph:
{
"agent": "graph.agent:app",
"env": ".env",
"auth": "jwt"
}
Save it as 10xgraph.json, then run the server with the playground:
pip install 10xgraph-api
10xgraph dev
From those two files you get REST and streaming endpoints, WebSocket, thread, memory and file APIs, health probes and the playground. 10xgraph build --docker-compose --k8s writes the Dockerfile, Compose file and Kubernetes manifest. For a scaffold with auth on, a Redis cache store, rate limits and tests, run 10xgraph init --template production. See Why 10xGraph and the server docs.
Building your own graph
Prebuilt agents are graphs. When you need custom control flow, build one directly:
from tenxgraph.core.graph import Agent, StateGraph, ToolNode
from tenxgraph.core.state import AgentState
from tenxgraph.utils.constants import END
graph = StateGraph()
graph.add_node("MAIN", Agent(
model="gemini/gemini-2.5-flash",
system_prompt=[{"role": "system", "content": "You are a support agent."}],
tool_node="TOOL",
))
graph.add_node("TOOL", ToolNode([lookup_order, refund_order]))
def route(state: AgentState) -> str:
if state.context and state.context[-1].tools_calls:
return "TOOL"
return END
graph.add_conditional_edges("MAIN", route, {"TOOL": "TOOL", END: END})
graph.add_edge("TOOL", "MAIN")
graph.set_entry_point("MAIN")
app = graph.compile()
Nodes can be plain functions too, so you can call a provider SDK directly. See Build a graph.
One stack
| Package | Role | Install | Source |
|---|---|---|---|
10xgraph (this repository) |
Core library: graph engine, durable state and checkpointing, long-term memory, replay-safe tools, MCP, publishers and tracing, evaluation | pip install 10xgraph |
10xGraph/10xGraph |
10xgraph-api (formerly 10xscale-agentflow-cli) |
API server and CLI: authentication, roles with reach, tenant isolation, cache store, background jobs, metrics, audit log, Docker and Kubernetes files | pip install 10xgraph-api |
10xGraph/10xgraph-api |
10xgraph-client (formerly @10xscale/agentflow-client) |
Typed TypeScript client: invoke, stream, threads, memory, files, client-side tools | npm install 10xgraph-client |
10xGraph/10xgraph-client |
| Docs | Tutorials, guides, concepts, reference | 10xgraph.com | 10xGraph/10xgraph-docs |
The playground is a React UI that 10xgraph dev opens against your local server (10xHub/agentflow-playground).
Built for teams going through SOC 2 and ISO 27001 audits: see the control mapping for which controls the stack supports and which stay with you.
Examples
Runnable scripts in examples/ (index in examples/README.md):
| Topic | Directory |
|---|---|
| Quickstart, graph basics, ReAct agents | quickstart/, graph_basics/, react/ |
| Streaming | streaming/, react_stream/ |
| Tools, injection, remote tools | tools/, dependency_injection/ |
| MCP servers and tools | mcp/, react-mcp/ |
| Persistence and checkpointing | persistence/, checkpointer/ |
| Long-term memory, RAG, vector stores | long_term_memory/, rag/ |
| Multi-agent: swarm, supervisor, handoff, plan-act-reflect | multi_agent/ |
| Human approval | human_in_the_loop/ |
| Resilience, graceful shutdown | resilience/, graceful_shutdown/ |
| Publishers and tracing | observability/ |
| Serving over the API | serving/ |
| Realtime audio, multimodal | realtime/, multimodal/ |
| Structured output, skills | structured_output/, skills/ |
| Providers | providers/ |
| Evaluation and testing | evaluation/, testing/ |
Run one:
export GEMINI_API_KEY=... # or OPENAI_API_KEY
python examples/quickstart/quickstart.py
Limits
- No hosted service. You run it, or nobody does.
- Authentication in the API server is off until you configure the
authkey. The production template (10xgraph init --template production) turns it on. - Tenant isolation needs columns you declare on the checkpointer and store. It is not automatic.
- A crash before a tool returns, or just before its record is written, can repeat that tool. Use idempotency keys for side effects.
- Automatic per-tool permissions (user A may call
refund, user B may not) are not built in. Tools can check the caller withtenxgraph.core.authz.can(config, "resource:action"). - Smaller community and fewer integrations than LangGraph or CrewAI. LangGraph has stronger visual tooling.
- Requires Python 3.12 or newer. Code-first, not a no-code builder.
- 10xGraph supports your SOC 2 and ISO 27001 controls; it does not hold an audit report of its own.
More: production limits.
Formerly Agentflow
10xGraph is the new name of Agentflow. The license and maintainers are the same. 10xscale-agentflow 0.10.1 is the last release under the old name. See coming from Agentflow.
pip uninstall 10xscale-agentflow
pip install 10xgraph
Uninstall first: both distributions provide the agentflow module and must not be installed side by side.
# before
from agentflow.core.graph import StateGraph
# after
from tenxgraph import StateGraph
The import name is tenxgraph because a Python identifier cannot start with a digit. Canonical paths are the old ones with agentflow replaced by tenxgraph (for example tenxgraph.core.graph, tenxgraph.storage.checkpointer, tenxgraph.prebuilt.agent). import agentflow keeps working as a deprecated alias until 2.0, with one DeprecationWarning.
| Item | Old | New |
|---|---|---|
| PyPI core | 10xscale-agentflow |
10xgraph |
| PyPI API and CLI | 10xscale-agentflow-cli |
10xgraph-api |
| npm client | @10xscale/agentflow-client |
10xgraph-client |
OpenTelemetry tracer and meter name, GEN_AI_SYSTEM |
agentflow |
10xgraph |
| Logger names | agentflow.* |
tenxgraph.* |
| Media URI scheme | agentflow://media/ |
graph://media/ (old URIs still read) |
| Default home directory | ~/.agentflow |
~/.10xgraph (falls back to ~/.agentflow if only that exists) |
| Cloud media prefix | agentflow-media |
10xgraph-media (old objects still read) |
| Server config file | agentflow.json |
10xgraph.json (the CLI falls back to agentflow.json) |
| CLI command | agentflow |
10xgraph (agentflow stays as a deprecated alias until 2.0) |
Contributing
Your avatar belongs on this wall.
Merge one pull request and you join them, here and on the contributor page at 10xgraph.com/maintainers.
Your first pull request can be small:
- Type one module.
pyproject.tomllists the modulesmypystill skips. Pick one, fix its types, delete its line. - Add the example you wish had existed. A runnable script in
examples/for a real use case: a support agent, a research pipeline, an approval flow. - Turn a bug into a failing test. Open it as a draft pull request; the fix can come later.
- Fix the docs where you got stuck. Every page on 10xgraph.com has an "Edit this page" link.
From clone to a passing check:
git clone https://github.com/10xGraph/10xGraph.git
cd 10xGraph
uv sync --dev
uv run pytest
uv run ruff check .
uv run mypy tenxgraph/
For bigger changes, start a thread in Discussions first. CONTRIBUTING.md has the full workflow, and the Code of Conduct applies everywhere.
Security
Found a vulnerability? Do not open a public issue. Follow the process in SECURITY.md.
License
10xGraph is MIT licensed and made by 10xScale. Copyright 10xScale. Contributions are accepted under the same license.
Links
- Documentation: 10xgraph.com
- PyPI:
10xgraph,10xgraph-api - npm:
10xgraph-client - Issues and Discussions
- Changelog
- Examples
Metadata
Release files for 10xgraph 1.0.0rc5
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| 10xgraph-1.0.0rc5.tar.gz | 755.5 kB | Without provenance | Details for 10xgraph-1.0.0rc5.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| 10xgraph-1.0.0rc5-py3-none-any.whl | Python 3 | none | any | Details for 10xgraph-1.0.0rc5-py3-none-any.whl |
Total release size: 1.6 MB
Release files / 10xgraph-1.0.0rc5.tar.gz
| Download URL | 10xgraph-1.0.0rc5.tar.gz |
|---|---|
| Size | 755.5 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
8b263bd270588b78892b739ff25e4e57e42a0d803f91bafa14bee1fb0bf5c16c
|
|
BLAKE2b-256 checksum How to use checksums |
83d99f4e58365d028945bb13e7a6d1cd728907f4846f3b16aedc4044b5cd65f1
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.13.13
|
Release files / 10xgraph-1.0.0rc5-py3-none-any.whl
| Download URL | 10xgraph-1.0.0rc5-py3-none-any.whl |
|---|---|
| Size | 814.8 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
21f327935d49bd0c06d959f67af3fe466627e52df2998810dc08e9dbd42ba42c
|
|
BLAKE2b-256 checksum How to use checksums |
a196848b85a8bff7168a31185b80872f1b0528dc0cd82eca801ba85fb4ed3ef4
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.13.13
|
Security for 10xgraph 1.0.0rc5
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.