The AI you can see think.
Open-source. Self-hosted. Learns permanently.
Quick Start · Features · Install · Docs · Discord · License
An open-source AI platform that runs on your machine and shows you how it thinks. Every skill, tool, and decision is visible on a living brain canvas. It learns permanently, heals itself when things break, and gets better the more you use it.
Currently, Chvor runs locally. Do not expose your instance to the public internet without authentication (
CHVOR_TOKEN). Agent mode — public-facing with built-in auth and rate limiting — is coming soon.
One command — installs Node.js if needed, sets up everything, and launches the onboarding wizard:
# macOS / Linux
curl -fsSL https://raw.githubusercontent.com/luka-zivkovic/chvor/main/scripts/install.sh | bash
# Windows (PowerShell)
irm https://raw.githubusercontent.com/luka-zivkovic/chvor/main/scripts/install.ps1 | iexAfter install:
chvor start # Start the server
chvor stop # Stop the server
chvor update # Update to the latest versionOpen http://localhost:3001 — you'll see the brain canvas.
Other install methods
npm install -g @chvor/cli
chvor onboarddocker run -d --name chvor -p 3001:3001 -v ~/.chvor:/home/node/.chvor ghcr.io/luka-zivkovic/chvor:latestgit clone https://github.com/luka-zivkovic/chvor.git && cd chvor
docker compose up -dDownload .msi (Windows) or .dmg (macOS) — no terminal required.
git clone https://github.com/luka-zivkovic/chvor.git && cd chvor
pnpm install && cp .env.example .env
pnpm dev # opens localhost:5173Full guide: docs/INSTALL.md
A real-time visualization of your AI's reasoning. Every skill activation, tool call, and decision branch animates on an interactive node graph — not after the fact, but as it happens.
One AI, everywhere. Web Chat, Telegram, Discord, Slack, WhatsApp — same personality, same memory, same context across all channels.
Built on the Model Context Protocol. Connect any MCP server as a tool — filesystem, web search, databases, code execution. Tools auto-discover and appear on the canvas.
Skills define behavior with YAML — personality, trigger patterns, tool bindings, rules. Give your AI a name, a tone, and directives it always follows. No two Chvors are alike.
Not a simple vector store. A graph-based cognitive architecture with spaced repetition, emotional awareness, consolidation cycles, and predictive retrieval. Your AI learns permanently — important things strengthen, the rest fades naturally.
When a tool fails or a skill errors, Chvor detects the issue, retries with adjusted parameters, and recovers gracefully. Your AI doesn't crash — it adapts. All visible on the brain canvas.
Sentiment-aware responses. Your AI reads the conversation context and adapts its tone — more empathetic when you're frustrated, more concise when you're in a hurry.
Cron-based automations. Your AI runs tasks on a schedule and delivers results to any channel — daily summaries, monitoring alerts, reminders.
API keys and credentials stored with AES-256-GCM encryption. Zero plaintext storage. All data stays on your machine.
┌──────────────────┐
│ Brain Canvas │ React Flow
│ (Vite + React) │ Real-time execution viz
└────────┬─────────┘
│ WebSocket
┌────────┴─────────┐
│ Gateway │ Hono + Node.js
│ Orchestrator │ LLM routing, MCP, tools
└────────┬─────────┘
│
┌───────────────┼───────────────┐
│ │ │
┌─────┴─────┐ ┌─────┴─────┐ ┌──────┴──────┐
│ Web Chat │ │ Telegram │ │ Discord │
└───────────┘ └───────────┘ └─────────────┘
Monorepo (pnpm workspaces):
| Package | Stack |
|---|---|
apps/client |
Vite + React + React Flow + Tailwind v4 + Zustand |
apps/server |
Hono + better-sqlite3 + Vercel AI SDK |
packages/shared |
Shared TypeScript types |
| Variable | Required | Description |
|---|---|---|
ANTHROPIC_API_KEY |
One of these | Anthropic API key |
OPENAI_API_KEY |
One of these | OpenAI API key |
GOOGLE_API_KEY |
One of these | Google AI API key |
CHVOR_TOKEN |
No | Bearer token for API/WebSocket auth |
TELEGRAM_BOT_TOKEN |
No | Telegram bot token (or set via UI) |
DISCORD_BOT_TOKEN |
No | Discord bot token (or set via UI) |
SLACK_BOT_TOKEN |
No | Slack bot token (or set via UI) |
SLACK_APP_TOKEN |
No | Slack app-level token (or set via UI) |
| Doc | Description |
|---|---|
| Architecture | How the codebase fits together (start here for contributors) |
| Installation | CLI, desktop app, Docker, npm, source |
| Memory System | Graph-based cognitive memory with decay & consolidation |
| Channels | Telegram, Discord, Slack, WhatsApp integration |
| Skills & Tools | Skill system, MCP tools, and registry |
| Brain Canvas | Real-time execution visualizer |
| Schedules | Cron-based automation |
| Browser | Web agent and HTTP browse automation |
| PC Control | Screen control with vision pipeline |
| Knowledge | Document ingestion and fact extraction |
| Voice | Speech-to-text and text-to-speech |
| Emotions | VAD emotion model and personality presets |
| Webhooks | GitHub, Notion, Gmail webhook subscriptions |
| Registry | Skill/tool registry and publishing |
| Security | Security policy and self-hosting practices |
Landing page & web docs: chvor.dev · chvor.dev/docs
| Status | Feature |
|---|---|
| Shipped | Brain Canvas, Multi-Channel, MCP Tools, Skills, Cognitive Memory, Schedules, Emotion Engine, Self-Healing |
| Experimental | Desktop App (Tauri), A2UI (AI-to-UI), PC Control |
| In Progress | Skill Registry, Templates |
| Planned | Agent Mode, Team Workspaces, Voice Channels, Plugin SDK, Fine-tuning, Mobile App |
See the full roadmap on chvor.dev.
- Discord — Chat, ask questions, share builds
- GitHub Issues — Bug reports, feature requests
- Contributing — Setup instructions and guidelines
- Email — lukazivkovic58@gmail.com
Good places to start contributing:
- Issues labeled
good first issue - New MCP tool integrations
- Documentation improvements
Chvor is source-available under the Chvor Sustainable Use License v1.0.
- Personal use, self-hosting, internal business use — fully free
- Consulting and building workflows for clients — allowed
- Offering as a competing SaaS or embedding in a commercial product — requires a commercial agreement