Skip to content

Install

$git clone https://github.com/roampal-ai/roampal

Install command taken from the project's README or registry entry. Always review code before running it.

Roampal

Memory that learns what works. So you can do more of it.

Say it worked. Say it didn't. The AI remembers.

Stop re-explaining yourself every conversation. Roampal remembers outcomes, learns from feedback, and gets smarter over time—all 100% private and local.

85.8% non-adversarial on LoCoMo (1,986 questions). +23 pts over raw ingestion. Absorbs 1,135 poison memories losing only 4 pts. (Paper)


Benchmark Results

LoCoMo dataset (1,986 questions, 5 categories, corrected ground truths). Evaluated with roampal-labs. Dual-graded by local 20B + MiniMax M2.7.

Metric Result
Non-adversarial accuracy (MiniMax-regraded) 85.8%
Overall (all 5 categories) 76.6%
vs raw ingestion baseline +23 pts (76.6% vs 53.0%, p<0.0001)
Poison resilience -4.2 pts after 1,135 adversarial memories
No-memory baseline 6.0% (model has zero LoCoMo knowledge)
Architecture vs model Architecture: +23 pts. Model swap (GPT-4o-mini): 1.5-2.5 pts
  • System learns through natural conversation, not transcript ingestion
  • Absorbs 1,135 poison memories with spoofed trust signals, retaining 72.4% accuracy
  • Wilson scoring hurts retrieval at every stage (p<0.001) — removed from ranking

Component-level retrieval ablation

Config Hit@1 Clean Hit@1 Poison p-value
TagCascade + cosine 27.3% 29.0% baseline
Overlap + cosine 25.8% 28.0% p=0.0003
Pure CE 25.4% 28.4% —
TagCascade + Wilson 23.0% 25.0% p<0.0001
  • Cross-encoder: +17.8 Hit@1 over cosine (p<0.0001)
  • Tag routing (two-lane): +6.1 Hit@1 clean, +7.5 poison (p<0.0001)
  • Wilson: -4.3 Hit@1 in every configuration
  • Nursery slot: zero benefit (p=1.0)

Full methodology in roampal-labs


Quick Start

  1. Download from roampal.ai and extract
  2. Install Ollama or LM Studio
  3. Right-click Roampal.exe → Run as administrator
  4. Download a model in the UI → Start chatting!

Your AI starts learning about you immediately.


Table of Contents


Key Features

Memory That Learns

  • Outcome tracking: Scores every result (+0.2 worked, -0.3 failed)
  • Smart promotion: Good advice becomes permanent, bad advice auto-deletes
  • Cross-conversation: Recalls from ALL past chats

Your Knowledge Base

  • Memory Bank: Permanent storage of preferences, identity, goals
  • Books: Upload .txt/.md docs as searchable reference
  • Pattern recognition: Detects what works across conversations

Privacy First

  • 100% local: All data on your machine
  • Works offline: No internet after model download
  • No telemetry: Your data never leaves your computer

MCP Integration

Connect Roampal to Claude Desktop, Cursor, and other MCP-compatible tools.

Settings → Integrations → Connect → Restart your tool

Similar plugs

The agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.

Java 面试 & 后端通用面试指南,覆盖计算机基础、数据库、分布式、高并发、系统设计与 AI 应用开发

Build Agentic workflows, RAG pipelines, with rich AI model and tool support on one collaborative workspace. Deploy on cloud, VPC, or self-hosted, so teams move from prototype…

A cross-platform desktop All-in-One assistant for Claude Code, Codex, OpenCode, OpenClaw, Grok Build & Hermes Agent. Only official website: ccswitch.io