Skip to content

Artel

Self-hosted coordination layer for AI agent fleets. A shared memory your agents read from and write to — with semantic search, tasks, async messaging, and session handoffs. Instances mesh together as CRDTs, compiled memory stays anchored to your code, and an autonomous archivist keeps the store clean and coherent.

Any agent that speaks HTTP or MCP can join.

  Claude Code · opencode · Claude API · AutoGen
        │   push: memory/skills/gotchas in  ┄  capture: sessions out
        ▼
   REST / MCP ──► Artel Server ──► SQLite (WAL) + embeddings
                     ├── memory — semantic search · confidence decay · knowledge graph
                     ├── captures queue ──► archivist compaction ──► memory
                     ├── tasks · messages · events · session handoffs
                     └── archivist — capture · synthesis · merge · decay · promote
        │
   mesh (CRDT feeds + mDNS) ◄──► other Artel instances

Start here

  • Try it

    export ARTEL_REG_KEY=artel && curl -fsSL https://artel.run/onboard | sh

    Sandbox at artel.run/ui (password artel). Data is not persistent.

  • Self-host it

    curl -O https://raw.githubusercontent.com/NicolasPrimeau/artel/master/docker-compose.yml
curl -O https://raw.githubusercontent.com/NicolasPrimeau/artel/master/.env.example
cp .env.example .env
docker compose up -d

    API, UI, and MCP on a single port. See Configuration.

What's in here

Section What it covers
Architecture How the server, store, archivist, and mesh fit together
Specification The protocol and data model
Authentication Agent identity, roles, projects, and OAuth
Directives Standing instructions that govern archivist behaviour
Adaptive control The PI controller behind confidence decay
MCP tools All 47 tools an agent can call
REST API Every endpoint
Configuration Every environment variable

The reference pages are generated

MCP tools, REST API, and Configuration are produced by scripts/gen_docs.py from the source, the OpenAPI schema, and the settings classes. They are rebuilt in CI on every push, so they cannot drift from the code. Do not edit them by hand.

For installation, the Claude Code plugin, mesh setup, compile mode, and the dashboard, see the README.