Skip to content

Maven

A personal AI assistant. One Go binary that runs locally or in a container, talks to your favorite chat apps, schedules its own work, and delegates coding tasks to external agents.

Maven

Built on ageneral-agents-go.

What Maven does

  • Chat in your apps. Inbound messages from Telegram, Feishu (Lark), WeCom, Matrix, WhatsApp, and the built-in Web UI all flow through the same agent runtime.
  • Run on a schedule. Persistent cron jobs and a periodic heartbeat call the same execution path the chat surfaces use.
  • Speak and listen. The Web UI supports realtime browser voice via Deepgram STT and OpenAI/Deepgram/ElevenLabs/Cartesia TTS.
  • Delegate work. A Task tool runs in-process subagents (explore, plan, general-purpose). A DelegateTask tool launches external ACP coding agents (Claude Code, Gemini CLI, etc.) as subprocesses.
  • Remember. A primary-only memory plugin curates MEMORY.md; the agent appends to daily journals with remember, searches them with memory_search, and a background pass consolidates worth-keeping facts.
  • Stay private. All outbound HTTP respects HTTPS_PROXY, SSL_CERT_FILE, and NO_PROXY, so you can route everything through a vault like OneCLI.

Architecture at a glance

flowchart LR
    subgraph External
        Users[Chat apps & browser]
        LLM[LLM APIs]
    end
    subgraph "Maven process"
        Channels[Channel plugins]
        Bus[Message bus]
        Pipeline[Pipeline]
        Runtime[Agent runtime]
        Triggers[Triggers: cron, heartbeat, mem-consolidate]
    end
    Users <--> Channels
    Channels <--> Bus
    Bus <--> Pipeline
    Triggers --> Pipeline
    Pipeline --> Runtime
    Runtime --> LLM

One execution surface for chat, cron, heartbeat, and consolidation. One declarative Apply loop reconciles config into running state. Read Concepts: Architecture for the details.

Documentation map

  • Get started

    Install, configure, and run Maven for the first time.

  • Concepts

    Architecture, pipeline, plugins, sessions, streaming.

  • Guides

    Workspace, memory, skills, slash commands, cron, voice, subagents.

  • Channels

    Telegram, Feishu, WeCom, Matrix, WhatsApp, Web UI.

  • Deployment

    Docker, proxy, OneCLI vault.

  • Reference

    Configuration schema, CLI commands, environment, HTTP API.

License

MIT.