Skip to content

rocky007cn/ace-memory

Repository files navigation

Python License Dependencies Cloud Cost

♠ Ace

Give every AI tool persistent memory.
Free. Local. Self-improving.

⚠️ Important Note from the Author

I am not a programmer. This MCP server was built entirely by hand in VS Code — I don't read code well, and honestly I'm not sure what kind of mess I've made. If you're a developer, the source is open: please audit it and email me bugs. I will fix them.

New versions are in active development. Follow the repo or email me to guide the work.

Finally: please respect my copyright and license. Don't exploit this for free — the author comes from a business background and knows exactly how that game is played.

Above all — I hope you like it. ♠


The Problem

Every time you open an AI tool, it forgets who you are.

You tell ChatGPT your stack, your preferences, your project goals. The next day — gone. You tell Cursor your architecture decisions. Next session — blank. Every conversation starts from scratch.

The existing solutions solve this. But they do it by shipping your data to US clouds, locking you into subscriptions, and hiding how your memories evolve. You're paying to lose control.

That's backwards. Your memories should be yours.


What Ace Is

Ace is the memory layer that sits between you and any AI tool. It remembers everything — and gets smarter every time you use it.

Before Ace:                        After Ace:
You: "I use PostgreSQL"            You: "I use PostgreSQL"
AI:  "Noted."  [forgets]           AI:  → ace_save  [stored permanently]

Next day:                          Next day:
You: "What's my database?"         You: "What's my database?"
AI:  "I don't know."               AI:  → ace_search → "PostgreSQL — weight 0.8"
                                          → "You also prefer dark themes"
                                          → "Correction history: switched from MySQL"

It's not just storage. It's memory that learns.

👍 Boost → memories surface higher.
👎 Drop → bad memories sink.
✏️ Correct → original preserved, corrected version linked. Full evolution visible to AI.


Why Ace Over Everything Else

Mem0 claude-mem Zep / Letta Ace
Price 💰 Paid subscription 🆓 Free 💰 Paid 🆓 Free. Forever.
API key required
Where's your data? ☁️ US cloud 💻 Local ☁️ Cloud 💻 100% Local
Dependencies 50+ packages Node + Bun + ChromaDB + SQLite Docker + DB 2 packages
Information integrity ❌ Text chunked ⚠️ AI summarizes ❌ Compressed Full text. Never lost.
Memory evolution Weights adapt to feedback
Mistake correction Overwrites old Overwrites old Overwrites old Keeps original + linked evolution
Setup time 10+ minutes npx install Docker compose 30 seconds

Install in 30 Seconds

pip install ace-mcp pvm-memory

Want semantic search (database ≈ 数据库)? Optional, free, local:

pip install ace-mcp[semantic] pvm-memory

Paste into .vscode/mcp.json:

{
  "servers": {
    "ace": {
      "command": "python",
      "args": ["-m", "ace_mcp.server"]
    }
  }
}

Done. Your AI tools — Cursor, Trae, Claude Desktop, VS Code Copilot, Windsurf — all now share one persistent, learning memory.


How It Works

┌──────────────────────────────────────────────────────────┐
│  AI Tools                                                 │
│  Cursor  ·  Trae  ·  Claude  ·  Copilot  ·  Windsurf     │
│                                                          │
│           │ MCP Protocol (standard — no custom SDK)       │
│           ▼                                              │
│  ┌────────────────────────────────────┐                  │
│  │         Ace MCP Server             │                  │
│  │    12 tools · 2 dependencies       │                  │
│  │    ace_save  ace_search  ace_correct  ...             │
│  └────────────────┬───────────────────┘                  │
│                   ▼                                      │
│  ┌────────────────────────────────────┐                  │
│  │         PVM Memory Engine          │                  │
│  │    · Content-addressed (SHA-256)  │                  │
│  │    · Delta Rule weight evolution  │                  │
│  │    · Temporal decay (Ebbinghaus)  │                  │
│  │    · Relational edge propagation  │                  │
│  │    · Fuzzy attribution            │                  │
│  └────────────────┬───────────────────┘                  │
│                   ▼                                      │
│  ┌────────────────────────────────────┐                  │
│  │     ~/.ace/memory.jsonl            │                  │
│  │     Full text · Append-only        │                  │
│  │     Human-readable · Thread-safe   │                  │
│  └────────────────────────────────────┘                  │
│                                                          │
│  ┌────────────┐          ┌──────────────────┐            │
│  │ Desktop App │          │   Web Dashboard   │           │
│  │ (Tkinter)   │          │  localhost:8765   │           │
│  └────────────┘          └──────────────────┘            │
└──────────────────────────────────────────────────────────┘

What's in the Box

12 MCP Tools — Your AI's Full Memory Toolkit

Tool What it gives your AI
ace_save Store anything — preferences, decisions, facts, code patterns
ace_search Deterministic recall — keyword + content, no guessing
ace_get_context Session startup — "what did we talk about last time?"
ace_calibrate Memory evolution — weights go up or down with feedback
ace_correct The killer. Correct without losing the original.
ace_link Build relational edges between related memories
ace_forget Soft-delete — gone from view, preserved for audit
ace_timeline Chronological view of everything remembered
ace_compare Side-by-side: original vs corrected
ace_export Dump everything — JSON, text, or summary
ace_stats Engine health — total records, average weight, edge count
ace_fuzzy_attribution When uncertain, does NOT guess. Reports common features.

Desktop Dashboard

Not just MCP. A full GUI for managing your memory.

pip install ace-desktop
ace-desktop
  • Calendar timeline — browse by date
  • Source tracking — which AI tool created each memory
  • One-click boost / drop / correct
  • Project grouping & auto-related discovery

Web Dashboard

Zero-install. One command. Any browser.

python -m ace_desktop.web_server --open
# → http://localhost:8765

Embed in VS Code sidebar via Simple Browser. Keyboard-driven: / search, j``k navigate, b boost, d drop.


Data Security — Yours, Always

Ace is 100% local by design. There is no server to send data to. No API endpoint to call. No account to create.

Your memories live in ~/.ace/memory.jsonl — a plain JSONL file you can open with any text editor. You control backup, deletion, and access.

Competitors require your data on their servers because their business model depends on it. Ace doesn't — because ours doesn't.


For Teams & Enterprises

Ace integrates into your products — not the other way around.

from ace_mcp.server import tool_save, tool_search

# Your SaaS, desktop app, or AI platform
# now has persistent, self-improving memory.
# No cloud. No per-call fees. Your infrastructure.
Mem0 Enterprise Ace
Data location US cloud Your servers
Pricing model $100K+/yr, per-call One-time license
GDPR / data export compliance Risk Zero risk
Vendor lock-in Full stack None — plain JSONL file
Source code access ✅ — modify, extend, embed
Can resell as part of your product ✅ — with license

Built on PVM — Research-Backed

Ace is powered by Persistent Vector Memory (PVM), a novel memory engine that upgrades embeddings from disposable retrieval keys to evolvable memory primitives.

GitHub


License

BSL 1.1 → MIT (2030)

Use Terms
🧑‍💻 Personal Free forever
👥 Team (up to 10) Free
🏢 Commercial embedding One-time license required
📅 After 2030 Automatically MIT — fully open source

See LICENSE.


🔮 Coming Soon

Next Release — Ace Desktop
A local search tool like Everything — a lightning-fast local database.
AI module will be integrated in a future update.

Distributed Edition · Enterprise Edition
Already on the roadmap.

If you have the skills for secondary development — buy a commercial license now.
Because once I release the enterprise version, the price won't be the same.


Zero cloud. Zero GPU. Zero API keys. Zero cost.
Your memories. Your machine. Your rules.

About

Give every AI tool persistent memory. Free. Local. Self-improving. Zero cloud, zero API keys, 2 dependencies.

Topics

Resources

License

Stars

1 star

Watchers

0 watching

Forks

Packages

 
 
 

Contributors

Languages