README
¶
Memoh
Give every AI agent its own cloud computer. Open source.
Desktop, browser, network, and long-term memory — always on, even when your laptop is closed.
Memoh Cloud · Deploy to Server · Docs · Website · X
What is Memoh?
Memoh is an open-source multi-agent platform. Each agent gets its own cloud computer — a dedicated workspace with a filesystem, desktop, browser, network, and long-term memory. Your agents stay online 24/7, even when your laptop is closed.
Use your own API keys to run Memoh's built-in agent, or host your existing Claude Code and Codex agents inside Memoh workspaces.
Talk to them through Telegram, Discord, Lark, WeChat, Web UI, and more. They remember context across sessions and platforms, drive a browser, call MCP tools, and run scheduled tasks. Run one for yourself, assign one to each team member, or spin up a fleet.
Get Started
Memoh Cloud
[!TIP] Memoh Cloud is coming soon — zero setup, always-on agents in the cloud. Join the waitlist at memoh.ai/waitlist.
Deploy to Server
Self-host the full stack on your own infrastructure.
curl -fsSL https://memoh.sh | sh
More deployment options
Manual deployment:
git clone --depth 1 --recurse-submodules --shallow-submodules https://github.com/felinics/Memoh.git
cd Memoh
cp conf/app.docker.toml config.toml
# Edit config.toml
export MEMOH_INTERNAL_RPC_SHARED_SECRET="$(openssl rand -hex 32)"
docker compose up -d
The Compose stack runs Server and Channel as separate services. Keep the internal RPC secret private and use the same value whenever the stack is recreated.
Running without Docker (or upgrading an existing bare-metal install)? Leave internal_rpc.shared_secret empty in config.toml: the server then embeds the channel runtime and keeps running as a single all-in-one process — external channels, email, and webhook endpoints included — with no memoh-channel process required. Setting the secret opts into the split two-process deployment.
Existing setup checkouts can keep using git pull: the post-merge hook initializes the new
submodule, and setup enables recursive updates for future pulls. If that hook was never installed,
run mise run submodule-init once after upgrading.
GitHub's automatic “Source code” archives omit submodule contents. For a buildable release archive,
use the attached Memoh-<version>-source.zip or .tar.gz asset instead.
Use CN mirror for slow image pulls:
curl -fsSL https://memoh.sh | USE_CN_MIRROR=true shDo not run the whole installer with
sudo. The installer will usesudo dockerinternally if Docker requires it.
See DEPLOYMENT.md for custom configuration and production setup.
Why Memoh?
- Every agent gets its own computer: An isolated workspace with its own filesystem, network, desktop, and browser.
- Multi-user, multi-bot: Run one for yourself, deploy one for each family member, run a fleet on a single machine.
- Lightweight: Self-host the server on your own infrastructure, or connect through Memoh Cloud.
Features
- Multi-bot & multi-user: Multiple bots that chat privately, in groups, or with each other. Cross-platform identity binding.
- Isolated workspaces: Each bot has a dedicated filesystem, network, tools, and desktop.
- Built-in memory: Long-term memory across sessions and platforms, out of the box. Also supports Mem0, OpenViking.
- 10+ channels: Telegram, Discord, Lark, WeChat, QQ, Email, and more.
- MCP: Connect external tool servers. Each bot manages its own connections.
- Agent Hosting: Host external agents inside Memoh workspaces via ACP. Currently supports Codex and Claude Code, configured per bot.
- Browser Use: Drive a browser inside the workspace.
- Computer Use: Operate the workspace desktop for GUI workflows.
- Skills & Supermarket: Modular skills, install curated templates from Supermarket, delegate to sub-agents.
- Automation: Scheduled tasks for recurring workflows.
Sub-projects
- Twilight AI — A lightweight, idiomatic AI SDK for Go, inspired by Vercel AI SDK. Provider-agnostic (OpenAI, Anthropic, Google), with first-class streaming, tool calling, MCP, and embeddings.
- Connect It — A self-hosted connector gateway that securely stores SaaS credentials and gives agents access to integrations through a single MCP endpoint.
- UI — A Vue 3 design system for AI agent management interfaces, including a component library, design tokens, and skills that teach agents how to use them.
Project Status
Star History
Contributors
Community
LICENSE: AGPLv3
Made with ❤️ by MemohAI Team,
Copyright (C) 2026 MemohAI (memoh.ai). All rights reserved.
Directories
¶
| Path | Synopsis |
|---|---|
|
cmd
|
|
|
agent
command
|
|
|
bridge
command
|
|
|
channel
command
cmd/channel hosts external channel adapters, email receivers, and webhook endpoints as a standalone service.
|
cmd/channel hosts external channel adapters, email receivers, and webhook endpoints as a standalone service. |
|
gen-bridge-mtls
command
|
|
|
internal/channel
Package channel assembles the shared command-side Channel module: registry/manager/processor, discuss pipeline, email, and webhook tunnel.
|
Package channel assembles the shared command-side Channel module: registry/manager/processor, discuss pipeline, email, and webhook tunnel. |
|
internal/core
Package core assembles the shared command-side domain and agent runtime providers used by the Memoh binaries (all-in-one, channel).
|
Package core assembles the shared command-side domain and agent runtime providers used by the Memoh binaries (all-in-one, channel). |
|
synccaps
command
Command synccaps enriches the hand-maintained conf/providers templates with reasoning capabilities (thinking_mode + reasoning_efforts) derived from the LiteLLM model registry.
|
Command synccaps enriches the hand-maintained conf/providers templates with reasoning capabilities (thinking_mode + reasoning_efforts) derived from the LiteLLM model registry. |
|
internal
|
|
|
agent/adapter/acpprofile
Package acpprofile adapts the ACP runtime profile registry to the stable turn contract consumed by Channel.
|
Package acpprofile adapts the ACP runtime profile registry to the stable turn contract consumed by Channel. |
|
agent/adapter/acpsession
Package acpsession adapts Chat thread metadata to the minimal descriptor consumed by the ACP runtime.
|
Package acpsession adapts Chat thread metadata to the minimal descriptor consumed by the ACP runtime. |
|
agent/adapter/channelcontact
Package channelcontact adapts Channel routes to Agent messaging contacts.
|
Package channelcontact adapts Channel routes to Agent messaging contacts. |
|
agent/adapter/channelidentity
Package channelidentity adapts Channel configuration data to the neutral platform identity projection consumed by Agent application orchestration.
|
Package channelidentity adapts Channel configuration data to the neutral platform identity projection consumed by Agent application orchestration. |
|
agent/adapter/channelmessaging
Package channelmessaging adapts Agent-owned messaging ports to the Channel delivery runtime.
|
Package channelmessaging adapts Agent-owned messaging ports to the Channel delivery runtime. |
|
agent/application
Package application orchestrates agent turns, including context assembly, persistence, memory, compaction, approvals, and runtime invocation.
|
Package application orchestrates agent turns, including context assembly, persistence, memory, compaction, approvals, and runtime invocation. |
|
agent/background
Package background implements a background task manager for long-running commands and subagent work.
|
Package background implements a background task manager for long-running commands and subagent work. |
|
agent/context/fragment
Package contextfrag defines the typed intermediate representation used to describe context before it is rendered into provider-specific SDK inputs.
|
Package contextfrag defines the typed intermediate representation used to describe context before it is rendered into provider-specific SDK inputs. |
|
agent/decision
Package decision holds app-layer decision DTOs and shared waiting primitives.
|
Package decision holds app-layer decision DTOs and shared waiting primitives. |
|
agent/decision/feedback
Package feedback defines stable user-facing Agent Control Protocol errors.
|
Package feedback defines stable user-facing Agent Control Protocol errors. |
|
agent/event
Package event defines the stream events shared by agent runtimes and the conversation layer.
|
Package event defines the stream events shared by agent runtimes and the conversation layer. |
|
agent/event/payload
Package payload defines the on-wire shapes for agent-emitted events published to the chat event hub.
|
Package payload defines the on-wire shapes for agent-emitted events published to the chat event hub. |
|
agent/runtime/acp
Package acp manages long-lived Agent Control Protocol runtimes.
|
Package acp manages long-lived Agent Control Protocol runtimes. |
|
agent/runtime/acp/client
Package client manages Agent Control Protocol processes, sessions, and events.
|
Package client manages Agent Control Protocol processes, sessions, and events. |
|
agent/runtime/session/ledger
Package ledger is the durable half of the session runtime: the record of which runs were admitted, who owns them, and how they ended.
|
Package ledger is the durable half of the session runtime: the record of which runs were admitted, who owns them, and how they ended. |
|
agent/turn
Package turn defines the application-level contract for starting and observing agent turns.
|
Package turn defines the application-level contract for starting and observing agent turns. |
|
botbackup/secure
Package secure provides passphrase-based authenticated encryption for bot backup bundles.
|
Package secure provides passphrase-based authenticated encryption for bot backup bundles. |
|
capabilities
Package capabilities derives model reasoning capabilities (thinking mode and effort tiers) from the LiteLLM model registry.
|
Package capabilities derives model reasoning capabilities (thinking mode and effort tiers) from the LiteLLM model registry. |
|
channel
Package channel provides a unified abstraction for multi-platform messaging channels.
|
Package channel provides a unified abstraction for multi-platform messaging channels. |
|
channel/adapters/dingtalk
Package dingtalk implements the DingTalk channel adapter.
|
Package dingtalk implements the DingTalk channel adapter. |
|
channel/adapters/feishu
Package feishu implements the Feishu (Lark) channel adapter.
|
Package feishu implements the Feishu (Lark) channel adapter. |
|
channel/adapters/feishu/wsclient
Package wsclient is a Feishu/Lark long-connection websocket client.
|
Package wsclient is a Feishu/Lark long-connection websocket client. |
|
channel/adapters/local
Package local implements the CLI and Web channel adapters for local development.
|
Package local implements the CLI and Web channel adapters for local development. |
|
channel/adapters/misskey
Package misskey implements the Misskey channel adapter.
|
Package misskey implements the Misskey channel adapter. |
|
channel/adapters/telegram
Package telegram implements the Telegram channel adapter.
|
Package telegram implements the Telegram channel adapter. |
|
channel/common
Package common provides shared utilities for channel adapters.
|
Package common provides shared utilities for channel adapters. |
|
channel/partsfixture
Package partsfixture exposes the canonical Message.Parts fixture used by the cross-platform rendering regression tests.
|
Package partsfixture exposes the canonical Message.Parts fixture used by the cross-platform rendering regression tests. |
|
channel/publicmedia
Package publicmedia defines signed public image media paths shared by channel adapters and HTTP handlers.
|
Package publicmedia defines signed public image media paths shared by channel adapters and HTTP handlers. |
|
channelaccess
Package channelaccess wires together the global account binding (channel identity <-> web user) and the per-bot Manage capability, resolving the effective Manage as "local override ?? inherited from bound web member".
|
Package channelaccess wires together the global account binding (channel identity <-> web user) and the per-bot Manage capability, resolving the effective Manage as "local override ?? inherited from bound web member". |
|
chat/timeline
Package timeline implements the Deterministic Context Pipeline (DCP) for assembling LLM context from canonical IM events.
|
Package timeline implements the Deterministic Context Pipeline (DCP) for assembling LLM context from canonical IM events. |
|
connectors
Package connectors manages bot-scoped bindings to the trusted Connect-It deployment.
|
Package connectors manages bot-scoped bindings to the trusted Connect-It deployment. |
|
httpx
Package httpx holds tiny echo-boundary helpers shared by the server shell and HTTP handlers.
|
Package httpx holds tiny echo-boundary helpers shared by the server shell and HTTP handlers. |
|
i18n
Package i18n provides a tiny, zero-dependency localization catalog for the IM command UI (slash commands, inline-keyboard buttons, renderer chrome).
|
Package i18n provides a tiny, zero-dependency localization catalog for the IM command UI (slash commands, inline-keyboard buttons, renderer chrome). |
|
memory/migrate
Package migrate contains utilities that convert existing markdown-backed memory content into the PostgreSQL wiki/graph schema (memory_nodes + memory_edges).
|
Package migrate contains utilities that convert existing markdown-backed memory content into the PostgreSQL wiki/graph schema (memory_nodes + memory_edges). |
|
memory/segment
Package segment tokenises memory text for lexical scoring, with first-class support for CJK (Chinese/Japanese) text.
|
Package segment tokenises memory text for lexical scoring, with first-class support for CJK (Chinese/Japanese) text. |
|
memory/wikistore
Package wikistore provides a graph store over the memory_nodes / memory_edges tables.
|
Package wikistore provides a graph store over the memory_nodes / memory_edges tables. |
|
reasoning
Package reasoning owns every decision about extended thinking: what a user may select for a model, and what a call actually sends upstream.
|
Package reasoning owns every decision about extended thinking: what a user may select for a model, and what a call actually sends upstream. |
|
storage
Package storage defines the Provider interface for object storage backends.
|
Package storage defines the Provider interface for object storage backends. |
|
storage/providers/containerfs
Package containerfs implements storage.Provider for bot containers backed by gRPC calls to the in-container MCP service.
|
Package containerfs implements storage.Provider for bot containers backed by gRPC calls to the in-container MCP service. |
|
storage/providers/fallback
Package fallback implements storage.Provider that tries a primary provider first (e.g.
|
Package fallback implements storage.Provider that tries a primary provider first (e.g. |
|
storage/providers/localfs
Package localfs implements storage.Provider backed by the host filesystem.
|
Package localfs implements storage.Provider backed by the host filesystem. |
|
team
Package team holds the default team identity used by self-hosted Memoh.
|
Package team holds the default team identity used by self-hosted Memoh. |
|
toolcontext
Package toolcontext owns the request-scoped identity and lifecycle shared by every Memoh tool transport.
|
Package toolcontext owns the request-scoped identity and lifecycle shared by every Memoh tool transport. |
|
workdir
Package workdir manages named per-bot working directories.
|
Package workdir manages named per-bot working directories. |
|
workspace/bridge
Package bridge provides a gRPC client for the workspace container bridge service.
|
Package bridge provides a gRPC client for the workspace container bridge service. |
|
workspace/vpath
Package vpath resolves user-supplied paths under a virtual workspace root without consulting the host filesystem.
|
Package vpath resolves user-supplied paths under a virtual workspace root without consulting the host filesystem. |
|
Package spec Code generated by swaggo/swag.
|
Package spec Code generated by swaggo/swag. |
|
Package templates holds the built-in files seeded into every agent workspace on first boot: the AGENTS.md persona scaffold, memory notes, and the default .memoh directory (hooks, built-in skills).
|
Package templates holds the built-in files seeded into every agent workspace on first boot: the AGENTS.md persona scaffold, memory notes, and the default .memoh directory (hooks, built-in skills). |
Click to show internal directories.
Click to hide internal directories.