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.

Quick Start

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 | iex

After install:

chvor start       # Start the server
chvor stop        # Stop the server
chvor update      # Update to the latest version

Open http://localhost:3001 — you'll see the brain canvas.

npm

npm install -g @chvor/cli
chvor onboard

Docker

docker run -d --name chvor -p 3001:3001 -v ~/.chvor:/home/node/.chvor ghcr.io/luka-zivkovic/chvor:latest

Docker Compose

git clone https://github.com/luka-zivkovic/chvor.git && cd chvor
docker compose up -d

Desktop App experimental

Download .msi (Windows) or .dmg (macOS) — no terminal required.

From Source

git clone https://github.com/luka-zivkovic/chvor.git && cd chvor
pnpm install && cp .env.example .env
pnpm dev  # opens localhost:5173

Full guide: docs/INSTALL.md

Features

Brain Canvas

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.

Multi-Channel

One AI, everywhere. Web Chat, Telegram, Discord, Slack, WhatsApp — same personality, same memory, same context across all channels.

MCP-Native Tools

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 & Personality

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.

Cognitive Memory

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.

Self-Healing

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.

Emotion Engine

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.

Scheduled Tasks

Cron-based automations. Your AI runs tasks on a schedule and delivers results to any channel — daily summaries, monitoring alerts, reminders.

Encrypted at Rest

API keys and credentials stored with AES-256-GCM encryption. Zero plaintext storage. All data stays on your machine.

Architecture

                     ┌──────────────────┐
                     │   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

Configuration

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)

Documentation

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

Roadmap

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.

Community

Discord — Chat, ask questions, share builds
GitHub Issues — Bug reports, feature requests
Contributing — Setup instructions and guidelines
Email — [email protected]

Good places to start contributing:

Issues labeled good first issue
New MCP tool integrations
Documentation improvements

License

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

Chvor

README