Skip to content
2648782102Public

About

A headless-capable personal agent runtime with a versioned API for CLI, desktop, and third-party clients.

Topics

Resources

Contributing

Security policy

Stars

1 star

Watchers

0 watching

Forks

Repository files navigation

Conchbase

Conchbase is a local-first runtime for a personal AI Agent. It owns the Agent loop, model calls, tools, permissions, conversations, durable work, and local state. Pagurus is the optional web console; the CLI and other clients use the same Runtime API.

Quick start

Requirements: Node.js 24 or newer.

npm ci
npm run dev
curl http://127.0.0.1:4318/v1/health

For a first model call, configure a local OpenAI-compatible Magpie gateway and set CONCHBASE_MODEL. The gateway is an adapter, not the product identity. Use npm run cli -- models to inspect its catalog and npm run cli -- run "reply with ok" for a smoke call.

Read next

The docs/ directory intentionally contains only current product and engineering documentation. The code and tests are the source of implementation history.

Product direction

The priority is a dependable private assistant: clear conversation, bounded tools, explicit approvals, durable memory, restart recovery, useful evidence, and a simple local operating workflow. Cloud deployment, broad integrations, and arbitrary host control come later, one complete and testable slice at a time.

Development checks

npm run check
npm test
npm run build

Automated tests use fake local providers, temporary databases, and temporary workspaces. Do not commit credentials or private user data.

MIT licensed. See LICENSE.

About

A headless-capable personal agent runtime with a versioned API for CLI, desktop, and third-party clients.

Topics

Resources

Contributing

Security policy

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages