{"id":50619365,"url":"https://github.com/alexclowe/abf","last_synced_at":"2026-06-23T05:00:30.210Z","repository":{"id":347899420,"uuid":"1166344897","full_name":"alexclowe/abf","owner":"alexclowe","description":"ABF (Agentic Business Framework) is an open-source TypeScript/Node.js framework for building businesses that run on coordinated AI   agents. You feed it a business plan (or answer interview questions), and it generates a full agent team — with roles, tools, memory, workflows, and a web dashboard — in minutes. ","archived":false,"fork":false,"pushed_at":"2026-04-09T00:57:53.000Z","size":22254,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-04-09T02:36:20.106Z","etag":null,"topics":["agents"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/alexclowe.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-02-25T05:55:57.000Z","updated_at":"2026-04-09T00:57:50.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/alexclowe/abf","commit_stats":null,"previous_names":["alexclowe/abf"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/alexclowe/abf","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alexclowe%2Fabf","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alexclowe%2Fabf/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alexclowe%2Fabf/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alexclowe%2Fabf/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/alexclowe","download_url":"https://codeload.github.com/alexclowe/abf/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alexclowe%2Fabf/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34675970,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-23T02:00:07.161Z","response_time":65,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["agents"],"created_at":"2026-06-06T10:00:20.063Z","updated_at":"2026-06-23T05:00:30.189Z","avatar_url":"https://github.com/alexclowe.png","language":"TypeScript","funding_links":[],"categories":["Business Operating Systems"],"sub_categories":[],"readme":"# ABF -- Agentic Business Framework\n\n**Build companies that run on AI agents.** Not companies that use AI -- companies where agents ARE the employees.\n\n\u003c!-- badges --\u003e\n![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)\n![Node.js 20+](https://img.shields.io/badge/node-%3E%3D20-green.svg)\n![TypeScript](https://img.shields.io/badge/TypeScript-5.8-blue.svg)\n![v1.3.0](https://img.shields.io/badge/version-1.3.0-brightgreen.svg)\n\n```bash\nnpx @abf/cli init --template solo-founder --name my-business\ncd my-business\nabf auth anthropic\nabf dev\n# Open http://localhost:3000\n```\n\nThree agents are now running: an executive assistant, a researcher, and a content writer -- coordinating through a message bus, sharing memory, and reporting to you through a web dashboard. That took under 2 minutes.\n\n---\n\n## Why ABF?\n\nMost AI agent frameworks are developer tools. ABF is a business-building framework. The difference:\n\n- **Describe your business, get an agent team.** ABF's Seed-to-Company pipeline reads your business plan (or interviews you about your idea) and generates a complete agent team -- roles, tools, knowledge base, workflows, and project structure. No configuration required.\n- **Two users, one framework.** Operators manage agents through a visual Dashboard. Builders work in YAML, TypeScript, and the CLI. Both see the same system.\n- **Files are the API.** Every agent definition, memory file, and configuration is a plain file (YAML, Markdown, JSON). Version control, code review, and diffing work out of the box.\n- **Security is structural, not optional.** Behavioral bounds are enforced by the runtime, not the LLM. Agents cannot bypass their permissions. Approval queues gate sensitive actions. Everything is audited.\n\n---\n\n## Documentation\n\n### Start here\n\n| | |\n|---|---|\n| **[Getting Started](docs/getting-started.md)** | Install ABF, create a project, run your first agent, and customize it. Takes 5 minutes. |\n| **[Concepts](docs/concepts.md)** | Understand ABF's 6 primitives: Agents, Teams, Memory, Bus, Tools, and Triggers. |\n\n### Build your business\n\n| | |\n|---|---|\n| **[Seed-to-Company Guide](docs/guides/seed-to-company.md)** | Turn a business plan, pitch deck, or interview into a running agent team. |\n| **[Security Guide](docs/security.md)** | Risks of autonomous agents, how ABF protects you, deployment checklist, and incident response. |\n\n### Deploy and operate\n\n| | |\n|---|---|\n| **[Self-Hosting Guide](docs/self-hosting.md)** | Deploy with Docker, Railway, Render, or Fly.io. Production configuration. |\n| **[API Reference](docs/api-reference.md)** | All 45+ REST API endpoints with request/response shapes. |\n\n### Contribute\n\n| | |\n|---|---|\n| **[Contributing Guide](CONTRIBUTING.md)** | Developer setup, conventions, and how to add tools, archetypes, and templates. |\n| **[Changelog](CHANGELOG.md)** | Release history. |\n| **[Security Policy](SECURITY.md)** | Vulnerability reporting and disclosure process. |\n\n---\n\n## What You Can Build\n\nABF ships with 3 templates and can generate custom teams from any business description:\n\n| Template | Agents | Use Case |\n|---|---|---|\n| **Solo Founder** | Compass (assistant), Scout (researcher), Scribe (writer) | One-person startup needing a virtual executive team |\n| **SaaS Startup** | Atlas, Scout, Scribe, Signal, Herald | Early-stage SaaS with product and go-to-market teams |\n| **Marketing Agency** | Director, Strategist, Copywriter, Analyst | Campaign planning, copywriting, and analytics |\n| **Custom (Seed)** | AI-designed team | Any business: upload a plan or answer interview questions |\n\nHave a business plan? Generate a custom team -- and a plan to build the product -- in one command:\n\n```bash\nabf init --seed ./my-business-plan.md\n```\n\nABF accepts `.docx`, `.pdf`, `.txt`, and `.md` files. When your seed document describes a product to build (SaaS, marketplace, platform), the analyzer generates an **adaptive build plan** alongside the agent team. A Builder agent orchestrates product construction -- provisioning databases, generating frontends, configuring payments, deploying -- with human approval at every critical step. [Full Seed-to-Company guide](docs/guides/seed-to-company.md).\n\n---\n\n## How It Works\n\nABF is built on **6 primitives**: [Agents](docs/concepts.md) (autonomous workers with roles and tools), [Teams](docs/concepts.md) (agent groups with an orchestrator), [Memory](docs/concepts.md) (5-layer persistence from session to knowledge base), a [Message Bus](docs/concepts.md) (typed inter-agent communication), [Tools](docs/concepts.md) (30+ built-in, MCP servers, and custom `.tool.js`), and [Triggers](docs/concepts.md) (cron, event, message, webhook).\n\nThe runtime is a single Node.js process with five components:\n\n![ABF Runtime Architecture](docs/images/runtime-architecture.png)\n\n**Scheduler** fires triggers. **Dispatcher** spawns work sessions. **Session Manager** runs an 8-step lifecycle: load context, build prompt, call LLM, execute tools, route messages, write memory, check escalations, log results. **Bus** routes inter-agent messages. **Gateway** serves the REST API, SSE events, webhooks, and Dashboard on a single port.\n\nRead the [Concepts Guide](docs/concepts.md) for the full explanation.\n\n---\n\n## Security\n\nAutonomous agents run with real credentials and take real actions. ABF is built for containment:\n\n- **Behavioral bounds** enforced by the runtime (not the LLM) gate every action\n- **Credential isolation** -- each tool only sees the API keys it needs ([ScopedVault](docs/security.md#2-credential-isolation))\n- **Execution sandboxing** -- code runs without access to credentials or home directory\n- **Approval queues** -- sensitive actions require human sign-off before executing\n- **Prompt injection defense** -- source tagging, content isolation, and detection pipeline\n- **Full audit trail** -- every session, tool call, message, and memory write is logged\n\nNo framework makes autonomous agents completely safe. The [Security Guide](docs/security.md) is transparent about what ABF protects against, what it cannot, and how to configure your deployment for safety. Required reading before going to production.\n\n---\n\n## Deployment\n\n```bash\nabf deploy --target railway    # or: render, fly\n```\n\n[![Deploy on Railway](https://railway.app/button.svg)](https://railway.com/deploy?repo=https://github.com/alexclowe/abf\u0026branch=main\u0026envs=ABF_VAULT_PASSWORD,ANTHROPIC_API_KEY\u0026optionalEnvs=ANTHROPIC_API_KEY\u0026ABF_VAULT_PASSWORDDesc=Encryption+password+for+credential+vault\u0026ANTHROPIC_API_KEYDesc=Optional+Anthropic+API+key+(can+configure+later+via+dashboard))\n\n[![Deploy to Render](https://render.com/images/deploy-to-render-button.svg)](https://render.com/deploy?repo=https://github.com/alexclowe/abf)\n\nDocker, Railway, Render, and Fly.io are all supported. See the [Self-Hosting Guide](docs/self-hosting.md) for production configuration including PostgreSQL, Redis, TLS, and API authentication.\n\n---\n\n## Tech Stack\n\n| Layer | Technology |\n|---|---|\n| Runtime | Node.js / TypeScript |\n| Dashboard | React / Next.js 15 |\n| Default storage | Filesystem (Markdown files) |\n| Production storage | PostgreSQL + pgvector |\n| Message bus | In-process (default), Redis / BullMQ |\n| LLM providers | Anthropic, OpenAI, Google, Ollama, any OpenAI-compatible |\n| Build system | pnpm workspaces + Turborepo |\n| API server | Hono |\n\n---\n\n## Contributing\n\n```bash\ngit clone https://github.com/alexclowe/abf.git\ncd abf\npnpm install    # requires pnpm 10+\npnpm build\npnpm test\n```\n\nThe monorepo has three packages: `packages/core` (runtime, providers, tools), `packages/cli` (CLI and templates), and `packages/dashboard` (Next.js dashboard). See [CONTRIBUTING.md](CONTRIBUTING.md) for conventions and guidelines.\n\n---\n\n## License\n\nMIT\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Falexclowe%2Fabf","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Falexclowe%2Fabf","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Falexclowe%2Fabf/lists"}