AI-Powered Agent Framework

Meet Wisemonkey
Your Intelligent Agent

A modular, multi-provider AI agent with persistent memory, vector search, MCP support, and a powerful tool system, all in a sleek terminal interface.

Get Started ↓ Explore Features →
Interactive Demo

See It In Action

A simulated Wisemonkey session — the welcome screen you see on first launch, followed by example prompts showcasing natural-language control over tools, memory, providers, and MCP servers.

wisemonkey — default
.-"-. _/.-.-.\_ ( ( o o ) ) |/ " \| \ ݁݁ ⏝ / /`"""`\ / \ ██ ██ ██ ▄█████ ██████ ██▄ ▄██ ▄████▄ ███ ██ ██ ▄█▀ ██████ ██ ██ ██ ▄█▄ ██ ██ ▀▀▀▄▄▄ ██▄▄ ██ ▀▀ ██ ██ ██ ██ ▀▄██ ████ ██▄▄ ▀██▀ ▀██▀██▀ ██ █████▀ ██▄▄▄▄ ██ ██ ▀████▀ ██ ██ ██ ▀█▄ ██▄▄▄▄ ██
⇒ Wisemonkey v2026.6.2 commit: 915a193
✓ Up to date

⇒ Session restored: 'my-session'
location:      ~/.local/share/wisemonkey/sessions/my-session
working dir:   ~/Projects/wisemonkey
created:       2026-05-29 08:27:51
last accessed: 2026-06-05 11:31:08

❯
Capabilities

Built for Power Users

Multi-Provider Support

Connect to OpenAI, Anthropic, Ollama, LM Studio, or any OpenAI-compatible API. Switch providers on the fly.

Persistent Memory

Session-scoped chat history, user profiles, and notes that survive restarts. Your agent remembers everything.

Vector Search (RAG)

Embed PDFs and documents into a ChromaDB vector store. Retrieve relevant context on demand.

MCP Integration

Connect to Model Context Protocol servers for filesystem access, GitHub, databases, and more.

Dynamic Tool Registry

Register tools at runtime. MCP server tools are auto-discovered and injected into the agent's capabilities.

Streaming & Reasoning

Real-time token streaming with configurable reasoning effort. Watch your agent think step by step.

Get Started

Up and Running in Seconds

# One-line installation
$ curl -fsSL https://codeberg.org/langurmonkey/wisemonkey/raw/branch/master/install.sh | sh
# Interactive first-time configuration
$ wisemonkey --onboard
# Run the agent
$ wisemonkey [session-name]
# Install uv
$ curl -LsSf https://astral.sh/uv/install.sh | sh
# Interactive first-time configuration
$ uvx wisemonkey --onboard
# Run the agent
$ uvx wisemonkey [session-name]
# Clone repository
$ git clone https://github.com/wisemonkey/wisemonkey.git && cd wisemonkey
# Interactive first-time configuration
$ uv run wisemonkey --onboard
# Run the agent
$ uv run wisemonkey [session-name]
Configuration

One File, Total Control

On first run, Wisemonkey creates ~/.config/wisemonkey/config.yaml with sensible defaults. Works with any OpenAI-compatible endpoint out of the box.

model:
  # Provider: openai, ollama, lmstudio, anthropic, generic (OpenAI-compatible)
  provider: openai
  # Model name
  name: qwen/qwen3.6-35b-a3b
  base_url: http://127.0.0.1:1234/v1
  temperature: 0.8
  thinking:
    effort: medium
    display: false
 
embedding:
  name: qwen/qwen3-embedding-0.6b-gguf
  base_url: http://127.0.0.1:1234/v1
 
agent:
  system_prompt:
    You are a helpful AI assistant, expert in many domains of science [...]
  max_turns: 50
  markdown: false
  max_chat_history: 320000
  context_files:
    - AGENTS.md
  vi_mode: false
{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem", "/tmp"]
    }
  }
}
 
  # Use /mcp edit to modify, /mcp tools to list
# API key — loaded automatically by python-dotenv
OPENAI_API_KEY=your-api-key-here
 
# Searched in order:
# ./.env → ~/.config/wisemonkey/.env → ~/.env

OpenAI, Anthropic, and Ollama APIs

LM Studio, Claude, Ollama, OpenWebUI, or your own server. Just set base_url.

Reasoning Control

Set reasoning_effort to none, low, medium, or high. Toggle visibility with reasoning_visible.

Embeddings

Separate embedding model config. Use any OpenAI-compatible embedding endpoint for vector search.

vi Mode

Enable vi_mode for vim-style editing. Press v in normal mode to open your external editor.

Markdown output

Optional Markdown response formatting for better readability.

Standard mcp.json

Edit MCP servers in a format you are comfortable with.

By the Numbers

Wisemonkey at a Glance

5+
AI Providers
∞
MCP Servers
14
Built-In Tools
1
Binary
0
Config Headaches