AgentFactory

The universal AI agent factory — a Python SDK and a self-hosted Studio for building, running, and operating any AI agent.

AgentFactory is a configuration-driven Agent OS: instead of writing a new codebase for every agent you need, you define an agent's identity, tools, and rules as data and the same engine brings it to life — a software engineer, a research analyst, a customer assistant, anything.

• SDK — one pip install gives you LLM failover, persistent memory, native tool calling, streaming, skills, MCP, and human-in-the-loop approvals.
• Studio — a self-hosted multi-user dashboard: sign up, build agents, install tools/skills/MCP servers, run with full observability, and operate from a built-in terminal.

Table of Contents

• ✨ Features
• 🚀 Quick Start
• 🧩 SDK Usage
• 🖥️ CLI Reference
• 🏗️ Architecture
• 🛡️ Security
• 📚 Documentation
• 🤝 Contributing
• 📄 License

✨ Features

Engine

Studio platform

🚀 Quick Start

Option A — Self-host the Studio (full experience) ✅ this is the product

One command, one process, one port:

pip install 'agentfactory-studio[platform]'   # or: pip install -e .
agentfactory studio                            # builds the UI if needed

Open http://localhost:8000 — that's the Studio: sign up, create an agent, add tools/skills/MCP servers and a model connection with your own API key, run a task, and watch it stream — with approvals, memory, terminal, and full observability. API docs: http://localhost:8000/docs.

Step-by-step walkthrough of every feature (API + UI + tests): docs/testing.md — "Local Testing Guide"

# …or Docker (one container serves API + UI + worker)
docker build -t agentfactory .
docker run -d -p 8000:8000 \
  -e AGENTFACTORY_JWT_SECRET="$(openssl rand -hex 32)" \
  -v agentfactory-data:/data \
  agentfactory

PyPI note: the distribution publishes as agentfactory-studio because the bare agentfactory name is squatted on PyPI (placeholder 0.0.0 release by another author). The Python import package remains agentfactory. Until the first PyPI release, install from source: pip install git+https://github.com/theaaqibjavaid/agent-factory.git.

Option B — SDK only (no Studio UI)

pip install agentfactory-studio[all]   # all LLM providers
agentfactory init
agentfactory run

⚠️ Legacy v1 flow. init / run / create-agent / list-tools are the old SDK/approval-server commands, kept for backwards compatibility. For the current platform use agentfactory studio (Option A).

See docs/quick-start.md, docs/testing.md, and docs/self-host.md.

🧩 SDK Usage

import asyncio
from agentfactory import AgentFactory

async def main():
    factory = AgentFactory()
    agent = factory.create_agent("Senior")
    result = await agent.run("Implement user authentication")
    print(result)

asyncio.run(main())

Custom tools, skills, MCP servers, and memory integrate through the registry — see the API reference and tool system.

🖥️ CLI Reference

The command you want is agentfactory studio — it runs the whole product (API + Studio UI) on one port. The other commands below are legacy v1 SDK tooling; they still exist for backwards compatibility but you don't need them for the platform.

Full reference: docs/cli-reference.md.

🏗️ Architecture

┌────────────────────────────────────────────────────────────────┐
│                        Studio (web/)                           │
│  Dashboard · Agent editor · Tools/Skills/MCP · Terminal ·      │
│  Observability · Approvals · Settings                          │
└──────────────────────────────┬─────────────────────────────────┘
                               │ HTTP / SSE / WebSocket
┌──────────────────────────────▼─────────────────────────────────┐
│                 Platform API (agentfactory/app)                │
│  Auth · Workspaces · Agents · Runs · Proposals · Memories ·    │
│  Tools · Skills · MCP · Models · Marketplace · Terminal ·      │
│  Observability        (SQLite, argon2id, JWT rotation)         │
└──────────────────────────────┬─────────────────────────────────┘
                               │ in-process worker + run broker
┌──────────────────────────────▼─────────────────────────────────┐
│                    Runtime (agentfactory/runtime.py)            │
│  LLM failover · tool sandbox · skills · MCP attach ·           │
│  constitution · guardrails · budget alerts · notifications     │
└────────────────────────────────────────────────────────────────┘

More: docs/architecture.md, docs/design.md.

🛡️ Security

Security is a first-class concern: argon2id password hashing, JWT rotation with revocation, per-IP rate limiting on auth, opt-in encryption-at-rest (set AGENTFACTORY_ENCRYPTION_KEY to encrypt conversations, facts, plans, and approval data), validated + sandboxed custom tool execution with schema-validated tool arguments, MCP command/env allowlists, destructive-command guards, path allowlists, secret-scrubbed logs, and an automated security pipeline (bandit, pip-audit, mypy, coverage gate) in CI.

• Threat model + test plan: docs/security.md
• Reporting vulnerabilities: SECURITY.md

📚 Documentation

Full index: docs/SUMMARY.md

🤝 Contributing

We welcome contributions of all kinds — code, docs, issues, and feedback.

• CONTRIBUTING.md — dev setup, testing rules, PR workflow
• CODE_OF_CONDUCT.md — community standards
• CHANGELOG.md — release history
• SECURITY.md — reporting vulnerabilities

Every PR runs the full gate in CI: tests + coverage ≥ 80%, mypy, ruff, bandit, pip-audit, and the Studio build.

⭐ If AgentFactory helps you build something, star the repo — it tells us the work matters and helps others find it.

📄 License

MIT © 2026 AgentFactory Contributors