About this project

Vellium is a local-first desktop workbench for AI chat, character roleplay, live voice conversations, and long-form writing. It connects to OpenAI-compatible APIs, OpenRouter, LM Studio, Ollama, KoboldCpp, and configurable custom endpoints. Chats, characters, projects, settings, and knowledge collections are stored locally in SQLite. Key features include: - Chat and roleplay: branching timelines, message editing, multiple characters, personas, LoreBooks, author notes, scene state, prompt blocks, translation, attachments, export, and controllable automatic turns. - Reasoning-aware context: provider reasoning fields and traces can be displayed, bounded, persisted, and optionally returned to the model as context. - Live voice and Inochi2D avatars: microphone input, Whisper-compatible STT, streaming TTS, parameter-driven lip sync/emotions for puppets, model and RP controls, attachments, screen context, and chat tools in Live mode. - Writing: projects, chapters, scenes, Character Forge, summaries, rewrite and expansion actions, RAG context, DOCX import, and DOCX/Markdown export. - Characters and world data: character-card import/editing, manual character ordering, multi-character participation, LoreBooks, and world-info import. - Knowledge and RAG: collections, bounded ingestion, embeddings, optional reranking, and explicit bindings for Chat and Writing. - Providers: OpenAI-compatible APIs, KoboldCpp, custom endpoint adapters, manual model fallbacks, job-specific model routing, and API parameter policy. - Tools and extensions: MCP tool calls, structured image results, local plugins, themes, widgets, custom inspector fields, and desktop pets. - Local control: SQLite persistence, Full Local Mode, provider URL checks, permission-gated plugins, and separate security gates for powerful legacy workspace tools. The interface is translated into English, Russian, Chinese, and Japanese. Desktop builds are available for macOS (Apple Silicon and Intel), Windows (x64), and Linux (x64 AppImage). A headless local web mode is also available, serving the frontend and API without opening Electron. Data is stored locally with the primary database being vellum.db. Full Local Mode blocks configured public provider endpoints. Plugins are local extensions requiring permission review before enabling. MCP child processes are allowlisted and reject inline-eval launch forms.