{"id":48694668,"url":"https://github.com/agience/agience-core","last_synced_at":"2026-06-09T06:00:18.825Z","repository":{"id":258074282,"uuid":"864254360","full_name":"Agience/agience-core","owner":"Agience","description":"The operating system that AI workflows trust. Structure messy inputs. Establish identity. Track provenance. Build the durable data layer your AI workflows need to be trusted, reusable, and auditable.","archived":false,"fork":false,"pushed_at":"2026-06-09T03:15:50.000Z","size":3514,"stargazers_count":39,"open_issues_count":0,"forks_count":16,"subscribers_count":10,"default_branch":"main","last_synced_at":"2026-06-09T03:22:09.260Z","etag":null,"topics":["ai-agents","fastapi","knowledge-management","mcp","mcp-gateway","model-context-protocol","opensearch","provenance","reactjs","semantic-search","workflow-automation"],"latest_commit_sha":null,"homepage":"https://agience.ai","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Agience.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"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":"CLA.md"},"funding":{"github":"ikailo"}},"created_at":"2024-09-27T19:37:16.000Z","updated_at":"2026-06-09T03:15:54.000Z","dependencies_parsed_at":"2024-10-28T03:55:13.909Z","dependency_job_id":"cbbc57d2-8c2c-4ad8-81fd-c80330e906a1","html_url":"https://github.com/Agience/agience-core","commit_stats":null,"previous_names":["ikailo/agience","sagemindsai/agience","agience/agience"],"tags_count":5,"template":false,"template_full_name":null,"purl":"pkg:github/Agience/agience-core","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Agience%2Fagience-core","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Agience%2Fagience-core/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Agience%2Fagience-core/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Agience%2Fagience-core/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Agience","download_url":"https://codeload.github.com/Agience/agience-core/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Agience%2Fagience-core/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34093774,"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-09T02:00:06.510Z","response_time":63,"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":["ai-agents","fastapi","knowledge-management","mcp","mcp-gateway","model-context-protocol","opensearch","provenance","reactjs","semantic-search","workflow-automation"],"created_at":"2026-04-11T07:08:01.815Z","updated_at":"2026-06-09T06:00:18.814Z","avatar_url":"https://github.com/Agience.png","language":"Python","funding_links":["https://github.com/sponsors/ikailo"],"categories":[],"sub_categories":[],"readme":"# Agience\n\n**The operating system that AI workflows trust.**\n\nAgience turns AI-generated output into durable, governed knowledge artifacts with identity, provenance, and version history so humans and agents can safely collaborate on the same information substrate.\n\n---\n\n## Why Agience\n\nAI generates output. It doesn't create trust. Any LLM can produce summaries, drafts, and decisions at scale — but without identity and provenance, those outputs have no chain of custody and no reason for anyone downstream to build on them.\n\nAgience is what turns AI output into something an organization can actually rely on. When an agent ingests a transcript, the result is a set of typed artifact objects — decisions, actions, constraints — committed into versioned collections under human review. The same object a human edits in the UI is the object an agent reads over MCP. Accountability follows from the architecture, not from policies or prompts.\n\n---\n\n## Core Properties\n\n**Artifacts, not files.**\nEvery object — document, transcript, agent config, MCP server registration, collection entry — is an artifact. Typed content, structured context, stable ID, full version history, and a record of what produced it.\n\n**Human-in-the-loop is structural.**\nApproval gates are first-class operators in any workflow, not a policy layer you bolt on later. The architecture enforces the boundary; it does not rely on prompts.\n\n**MCP-native throughout.**\nAgience is both an MCP server (exposing tools to VS Code, Claude Desktop, Cursor, or any compatible client) and an MCP client (consuming GitHub, Slack, filesystem, and other vendor MCP servers). \n\n**Trust is declared, not assumed.**\nScoped API keys define exactly what each agent or server can read, write, or invoke. Identity comes from the auth token, never the request body. Delegated operations carry a record of who authorized them.\n\n**Provenance is infrastructure.**\nLike a filesystem journal, provenance in Agience is structural. Committed artifacts carry records of what produced them, from what inputs, under whose authority. Not a premium feature — a consequence of how the system is built.\n\n**Composable agent servers.**\nThe platform ships with eight purpose-built MCP servers covering ingestion, retrieval, reasoning, output, networking, security, governance, and finance. Each is a standalone FastMCP service. Deploy the ones you need, replace the ones you don't.\n\n---\n\n## The OS Analogy\n\n| OS Concept | Agience |\n|---|---|\n| File records / inodes | Artifacts |\n| Windows / explorer views | Cards (UI layer) |\n| File extensions | MIME content types |\n| Working directory | Workspace |\n| Published filesystem | Collection |\n| Save / publish | Commit |\n| Kernel services | Core platform |\n| Peripheral drivers | Agent persona servers |\n| Third-party applications | External MCP servers |\n| Processes / jobs | Agents / Operators |\n| System calls | MCP tool calls |\n| Filesystem indexer | MANTLE encrypted search (BM25 + IVF) |\n| Capability-based access | Scoped API keys |\n| Change journal | Provenance chain |\n\n---\n\n## What Ships Today\n\n- **Artifact model** — typed, versioned objects with stable IDs, full history, and graph relationships\n- **ArangoDB architecture** — all artifact storage in ArangoDB; workspaces for ephemeral drafts, collections for committed versions\n- **Commit flow** — explicit workspace → collection promotion; nothing published silently\n- **Encrypted hybrid search** — MANTLE-SSE blind-token BM25 + MANTLE encrypted IVF vector search, fused via RRF; all posting lists and embeddings AES-256-GCM at rest in S3\n- **Multi-provider OAuth2** — Google, Microsoft Entra, Auth0, custom OIDC, username/password; RS256 JWT + scoped API keys\n- **MCP server** — universal gateway in Chorus at `/{server_id}/mcp`; advertised via `/.well-known/mcp`; works in VS Code, Claude Desktop, Cursor\n- **Agentic chat loop** — chat artifacts with an 8-tool surface and multi-turn LLM loop\n- **Live stream ingestion** — OBS → SRS → real-time AWS Transcribe; transcript artifacts committed on stream end\n- **S3/CloudFront media handling** — direct browser-to-S3 presigned upload, signed CDN delivery, orphan cleanup\n- **Eight agent persona servers** — Astra (ingestion), Sage (retrieval), Verso (reasoning), Aria (output), Iris (comms), Mantle (governance), Seraph (security), Ophan (finance)\n\nSee [ROADMAP.md](ROADMAP.md) for the full capability inventory and what's coming next.\n\n---\n\n## Getting Started\n\n### Run Agience at Home (stable build)\n\nNo git clone needed. One command installs the full platform on your machine. Runs at `https://home.agience.ai` — that domain always resolves to `127.0.0.1`, so traffic never leaves your machine. Caddy fetches the TLS certificate automatically.\n\n**Windows (PowerShell):**\n```powershell\nirm https://get.agience.ai/install.ps1 | iex\n```\n\n**Linux / macOS:**\n```bash\ncurl -fsSL https://get.agience.ai/install.sh | sh\n```\n\nAfter that: `agience up` / `agience down` / `agience update`.\n\n\u003e **On a restricted network or prefer plain HTTP?**\n\u003e The plain mode runs at `http://localhost:8080` with no domain or certificate required.\n\u003e ```powershell\n\u003e irm https://get.agience.ai/install.ps1 | iex -Mode plain\n\u003e ```\n\u003e ```bash\n\u003e curl -fsSL https://get.agience.ai/install.sh | sh -s -- --mode plain\n\u003e ```\n\n### Developer Setup (build from source)\n\nFor contributors and developers who want to modify the platform:\n\n```bash\ngit clone https://github.com/Agience/agience-core.git\ncd agience-core\n```\n\n**Windows:**\n```\nagience dev -f --build\n```\n\n**Linux / macOS:**\n```bash\n./agience dev -f --build\n```\n\nThis starts the support containers (Arango / Postgres / MinIO) in Docker, installs Python dependencies into a `.venv`, and launches Origin / Mantle / Chorus / Facet locally. The setup wizard handles OAuth and LLM configuration on first boot — no manual `.env` file required.\n\nFull developer guide: [`docs/getting-started/local-development.md`](docs/getting-started/local-development.md)\n\n### Hosted\n\nSign up at [agience.ai](https://agience.ai) — no setup required.\n\n### Edge builds (contributors and testers)\n\nPublished on every merge to `main`. Not for production use.\n\n**Windows (PowerShell):**\n```powershell\nirm https://get.agience.ai/install.ps1 | iex -Channel edge\n```\n\n**Linux / macOS:**\n```bash\ncurl -fsSL https://get.agience.ai/install.sh | sh -s -- --channel edge\n```\n\n---\n\n## Architecture\n\nFour containers; the platform deploys as four named images plus three\nsupport services (`init`, `graph` / Arango, `sql` / Postgres, `content` /\nMinIO, `stream` / SRS) wired together by `docker compose`.\n\n```\n  ┌─────────────────────────────────────┐\n  │  Facet (React / Vite)               │  Cards, grid, windows, navigation\n  └─────────────────────────────────────┘\n                    │\n  ┌─────────────────────────────────────┐\n  │  Chorus (FastMCP unified host)      │  Aria · Astra · Sage\n  │  Universal MCP gateway, persona     │  Iris · Ophan · Seraph · Verso\n  │  servers, ui:// viewers             │  + relay WebSocket for desktop hosts\n  └─────────────────────────────────────┘\n                    │ HTTP JSON-RPC + REST\n  ┌─────────────────────────────────────┐    ┌─────────────────────────────┐\n  │  Mantle (FastAPI artifact kernel)    │    │  Origin (FastAPI identity)  │\n  │  Type-blind CRUD + commit + events  │    │  OIDC · grants · passkeys   │\n  │  Encrypted MANTLE+SSE search (S3)    │    │  Scoped API keys · setup    │\n  │  ArangoDB · MinIO · S3              │    │  Postgres                   │\n  └─────────────────────────────────────┘    └─────────────────────────────┘\n```\n\nArchitecture spec: [`.dev/features/four-container-architecture.md`](.dev/features/four-container-architecture.md)\n· [`.dev/features/layered-architecture.md`](.dev/features/layered-architecture.md)\n\n### Repo layout\n\n```\nsrc/origin/         Identity service (FastAPI + Postgres)\nsrc/mantle/          Artifact kernel (FastAPI + Arango + encrypted search)\nsrc/chorus/         Persona MCP servers + universal gateway (FastMCP)\nsrc/facet/          React + Vite + Tailwind UI\nsrc/kernel/         Shared Python (config, key_manager, scopes, embeddings)\npackage/types/      Builtin MIME type definitions (cross-service)\npackage/docker/     Compose files + per-service Dockerfiles\npackage/install/    Unified install.sh / install.ps1 + home + plain compose\npackage/seeds/      Declarative bootstrap artifacts\npackage/hosts/      Desktop companion relay runtime\ndocs/               Public-facing documentation\n.dev/features/      Internal design specs and migration plans\n```\n\n---\n\n## Documentation\n\n| | |\n|---|---|\n| [Platform Overview](docs/overview/platform-overview.md) | What ships and how it fits together |\n| [Self-Hosting Guide](docs/getting-started/self-hosting.md) | Deploy on your own infrastructure |\n| [MCP Setup](docs/mcp/client-setup.md) | Connect VS Code, Claude Desktop, Cursor |\n| [Search Query Language](docs/reference/search-query-language.md) | `+required`, `~semantic`, `type:`, `tag:` operators |\n| [MCP Overview](docs/mcp/overview.md) | Full MCP server and client architecture |\n| [ROADMAP.md](ROADMAP.md) | Shipped and in-progress capabilities |\n| [CONTRIBUTING.md](CONTRIBUTING.md) | Contribution guidelines and CLA |\n\n---\n\n## Contributing\n\nBug reports, documentation improvements, new agent tools, and thoughtful feature proposals are welcome.\n\n1. Read [CONTRIBUTING.md](CONTRIBUTING.md) and [CLA.md](CLA.md)\n2. Open an issue before writing code for new features\n3. Security issues → **security@agience.ai** (do not open a public issue)\n\n---\n\n## License\n\nAgience Core is licensed under the **GNU Affero General Public License v3.0** (AGPL-3.0-only).\n\n- **Free use**: open-source and AGPL-compliant deployments, including network-accessible services that share source\n- **Commercial license required**: proprietary/closed-source use, managed services without source disclosure, OEM/embedded distribution, white-label use\n\nSee [LICENSE.md](LICENSE.md).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fagience%2Fagience-core","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fagience%2Fagience-core","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fagience%2Fagience-core/lists"}