An open-source alternative to Alma.
No MCP, no plugin marketplace, skills-only.
Only what's necessary for a cyber-assistant that lives in your computer.
Because your AI assistant should be yours — not a platform, not a marketplace, not a maze of configuration files.
Most AI clients want to become ecosystems. They invent protocols, build plugin stores, and lock you into their infrastructure. Yachiyo does the opposite: it gives you a capable assistant that lives in your filesystem, respects your privacy, and gets out of your way.
Skills are just Markdown. Drop a SKILL.md file in your workspace and it works. No runtime. No API surface. No 47-step setup. If you can write a README, you can extend Yachiyo.
No vendor lock-in. Claude today, Gemini tomorrow, your own local model next week. Switch per-message if you want. Your history stays local in SQLite — not in someone else's cloud.
Reply branching. Conversations aren't linear. Branch from any point, explore different paths, navigate the tree. It's how you actually think.
Channels, not silos. One local instance serves Telegram, Discord, and QQ simultaneously with shared context and access control.
No MCP. No telemetry. No plugin marketplace. Just what's necessary for a cyber-assistant that lives in your computer.
- Fully agentic runtime — Yachiyo can search, read, edit, browse, recall memory, ask follow-up questions, run background shell tasks, and act on your local workspace with file attachments instead of staying a pure chat box.
- Built-in general-purpose skills — Core capabilities like browser work, document handling, spreadsheets, Zotero, terminal control, and CLI self-management ship as reusable skill modules.
- Coding agent dispatch — Delegate implementation work to Claude Code, Kimi, or Codex through ACP, then bring the result back into the same thread.
- Scheduled runs — Create one-off or cron-based tasks, keep run history, and let Yachiyo execute prompts on its own.
- Reply branching — Messages form a tree. Branch from any turn and navigate alternate replies instead of flattening everything into one timeline.
- Channel multiplexing — Serve Telegram, QQ (OneBot / QQBot), and Discord from one local instance with shared context, access control, and per-user limits.
- Group discussion mode — Built-in lurk/active/engaged state machine for group chats, with buffered context and autonomous participation.
- Browser-backed web research — Search with Google browser sessions or Exa, then read pages into Markdown/HTML with extraction fallbacks.
- Local memory & profile — Store durable memory, recall it into future runs, and keep
SOUL.md/USER.mdas first-class context. - Workspace file snapshots — Automatically track file changes across every run, with built-in diff review so you can see exactly what happened.
- Rich composer input — Send images, file attachments, and steer an active reply in real time or queue a follow-up without interrupting the current run.
- Multi-provider runtime — Anthropic, OpenAI, Gemini, Vertex AI, or custom gateway, with model selection inside the app.
- Local-first storage — SQLite + Drizzle ORM under
~/.yachiyo/, with no hosted backend required.
Compare different tones and keep the path you actually want without losing the other replies.
Configure providers locally, choose runtime behavior, and manage enabled models from one place.
Run prompts on a schedule, keep history, and treat recurring work like a first-class feature instead of a hack.
A focused essentials surface for keeping important context, reusable items, and workspace shortcuts close at hand.
"I have Claude Code and Codex working on different parts of the auth refactor. Send a prompt to both to 'run the latest migration and verify the schema,' then notify me when they finish."
Yachiyo acts as your central dispatcher. It handles the complex task of prompting multiple specialized agents, monitoring their progress through the Agent Client Protocol (ACP), and synthesizing their results into a single update.
"Find the latest Gemini 3.1 Pro pricing and update the project's provider configuration with the new rates."
Using a real, authenticated browser, Yachiyo navigates live documentation, extracts structured data (even from the newest 2026 models), and applies those updates to your local setup. It automates the "boring" research to keep your environment current.
"I want my responses to be more technical and concise. Update my profile and adjust your future behavior."
Yachiyo manages its own soul and your user profile through local Markdown files (
SOUL.mdandUSER.md). Your preferences aren't just settings—they are a durable, evolving memory that shapes every interaction across all channels.
Download the latest release from the Releases page. macOS only for now.
nvm use
pnpm install
pnpm devWorkspace packages:
apps/desktop— Electron desktop appapps/website— public websitepackages/shared— shared protocol and message utilitiespackages/runtime— local assistant runtimepackages/cli—yachiyocommand-line interface
Bug fixes and documentation improvements are welcome.
Feature PRs are not accepted unless the feature has been widely discussed and approved through an issue proposal first. Open an issue before writing code.
- Alma — the original inspiration for this project
- Defuddle — powers the web reader extraction, such a good tool
- Cahciua — group message structure reference
- Flowdown — thread emoji icon inspiration
The Yachiyo name, logo, and branding assets are not covered by this license and remain all rights reserved. See NOTICE for details.