mrkeyoor.com_
Mon 07 Sept 17:59 UTC
LLM Toolsevaluationupdated 07 Sept 2026

funes review

Funes turns past Claude Code, Codex, pi, and Hermes sessions into a searchable local memory that an AI coding agent can query later. It solves the familiar problem of decisions, dead ends, and useful findings disappearing when a session closes, while optionally sharing that history through a Hugging Face dataset.

trackingstars / 7d
Verdict

Our Funes run built in 773 seconds and passed all 554 tests in another 283 seconds, a strong result for a young Rust project with a heavy compile. Use it if lost coding-agent context is costing real time and you can keep memory local until a deliberate sharing review. Skip it on Windows or wherever an append-only remote transcript dataset creates an unacceptable data-retention risk.

We ran it

Lab card: what happened when we ran funesScreenshot of funes (github.com/huggingface/funes)
Install✓ · 34s910 packages
Build✓ · 773s
Tests✓ · 283s554 passed · 0 failed of 554 (cargo test)
Repo122 files~22,773 lines of source · 4.3 MB · 2 CI workflows · tests dir

Answers from our run

Does funes build from source?

Dependencies installed in 34 seconds (910 packages), and the build succeeded in 773 seconds. We cloned commit f27e6e1 into a clean Debian container with 3 CPUs and no project-specific setup.

Do funes's tests pass?

Yes: 554 of 554 passed when we ran the project's own test command (cargo test). Some failures need services or credentials a bare container does not have.

Who should not use funes?

Windows users today: v1.3.0 ships Linux and Apple Silicon macOS binaries, and open issue 136 asks when Windows support will arrive.

What are the alternatives to funes?

Mem0, Letta, QMD. Our Funes run built in 773 seconds and passed all 554 tests in another 283 seconds, a strong result for a young Rust project with a heavy compile.

Setup3/534-second install, but the Rust build took 773 seconds
Docs5/5Agent hooks, indexing, publishing, and security are explicit
Community3/5Active September work, but only 247 stars and a short history
Maturity3/5554 tests pass; Windows and more agent integrations remain open

Who it’s for

Developers who regularly switch among Claude Code, Codex, pi, or Hermes and want one searchable session history.
Teams willing to review and publish selected agent transcripts to a private Hugging Face dataset.
MCP users who need read-only recall, get, and status tools over local or remote memory.
Rust users who prefer local embedding and reranking over a hosted memory service.

Who it’s NOT for

Windows users today: v1.3.0 ships Linux and Apple Silicon macOS binaries, and open issue 136 asks when Windows support will arrive.
Teams that cannot let coding-session text leave the machine: binding a remote memory enables session-boundary pushes, and Funes cannot retract a session from an already published dataset.
Users unwilling to install TruffleHog for remote publishing: the outbound gate refuses to push if the scanner is missing or fails.
Cline or OpenCode users wanting automatic hooks now: the documented integrations cover four other agents, while issue 135 requests both additions.
Older Linux systems below glibc 2.35, which the README excludes from the default build.

Setup reality

Our sandbox install succeeded in 34 seconds and installed 910 packages. The Rust build succeeded in 773 seconds, then cargo test finished in 283 seconds with all 554 tests passing. The 4.3 MB checkout held 122 files and about 22,773 source lines.

Local use needs no hosted credential, but the first index obtains pinned embedding and reranking weights. Hub sharing needs a Hugging Face token, a dataset repository, and TruffleHog on PATH; Funes refuses remote pushes without the scanner. Agent setup also writes MCP registration and automation hooks into the selected agent's configuration.

Source builds require Rust and protoc. Prebuilt v1.3.0 assets cover Linux x86-64, Linux arm64, and Apple Silicon macOS, while Linux requires glibc 2.35 or newer. The repo has no Dockerfile, so containers need their own packaging.

Four coding-agent histories become one searchable local dataset

Funes reads sessions from Claude Code, Codex, pi, and Hermes, converts their different trace formats into one turn-and-block model, and stores the result in a local Lance dataset. Recall combines vector and BM25 search, reranks the candidates, and attaches session provenance so an agent can recover the surrounding turns with get. The appeal is practical: a decision made in Codex can be found from Claude Code weeks later without copying a hand-written summary between tools.

Version 1.3.0 gives those 4 agents more than a search command. funes add registers the read tools, builds an initial index, and installs per-turn indexing hooks. If the setup binds a Hub memory, hooks also publish at session boundaries. Other MCP clients can launch funes mcp to receive recall, get, and status, although that server is read-only. Indexing and publishing still need separate commands or an installed automation path.

A bound Hub memory can publish at every session boundary

Funes keeps parsing, embedding, reranking, and storage local by default. Sharing changes the data boundary. A published memory is a Hugging Face dataset owned by a user or organization, and repositories created by Funes start private. Existing repositories keep their current visibility. The setup command may offer to create and bind a remote when it detects a token; accepting that path enables automated pushes from supported agents after sessions end.

Coding transcripts can contain prompts, file contents, terminal output, environment variables, and reasoning that was never written for colleagues. Funes requires TruffleHog before remote publishing, scans reconstructed blocks, and withholds every chunk of a block when it detects a secret. The gate fails closed when scanning is unavailable. That is careful engineering, but secret scanning does not decide whether clean yet confidential product plans should leave a laptop. Teams still need a publication policy and dataset access review.

What happened when we ran it

Our sandbox installed commit f27e6e1 in 34 seconds, adding 910 packages. The release build succeeded in 773 seconds, or just under 13 minutes. Tests then took 283 seconds and passed all 554 cases with 0 failures. The checkout was compact before compilation: 122 files, roughly 22,773 lines of source, and 4.3 MB on disk. Those results came from 3 CPUs and 12 GB of RAM in the stated Rust container.

The clean test result is meaningful because this program touches sensitive transcripts and modifies agent integrations. It does not measure retrieval quality, model-download time, index size, or recall latency. We also did not publish a private dataset or test the four agent clients end to end. The repository includes 2 CI workflow files and a tests directory, but no Dockerfile. Buyers should treat our 554 passing tests as codebase evidence, not as proof that their own session corpus will produce useful retrieval.

Source builds need protoc, while v1.3.0 omits Windows

Building from source requires the Rust toolchain and protoc, either installed system-wide or bootstrapped into a repository-local tools directory. Funes pins its embedding model and records that identity in the memory; changing models requires rebuilding the derived dataset from retained raw text. Linux uses a pure Rust inference path and requires glibc 2.35 or newer. An optional ONNX feature changes the backend, so maintainers need to choose that path intentionally.

The v1.3.0 release publishes checksum-listed binaries for Linux x86-64, Linux arm64, and Apple Silicon macOS. There is no Intel macOS or Windows asset in the documented table. Open issue 136 asks about Windows and desktop-agent support, while issue 135 requests Cline and OpenCode integrations. A generic MCP client can read memory today, but it does not gain each named agent's indexing and session-boundary hooks automatically.

Remote memory is append-only and removal stays manual

Funes makes local cleanup safer than remote cleanup. funes scrub rescans stored blocks, replaces safely located secrets, drops blocks it cannot repair safely, and rebuilds indexes. Original transcripts remain untouched. If a credential has already reached the Hub, the security guide says to rotate it, delete and recreate the dataset repository, and push a scrubbed memory again. The tool itself does not remove the published copy.

Selected publishing also happens before upload. The --sessions option sends complete named sessions, and the remote format is append-only, so choosing a session is a lasting disclosure decision. funes remove reverses agent hooks and MCP registration but preserves local memory, model caches, original transcripts, and published datasets. That preservation is reasonable for an uninstall command, yet users expecting deletion must clean each store separately.

September activity is strong for a 247-star project

GitHub recorded the last push on September 7, 2026, six days after v1.3.0. The repository had 247 stars, 4 open issues, and 1 open pull request. Its first official release arrived July 17, less than a month after the repository was created, followed by several releases through September. Recent work covers publishing convergence, status reporting, session browsing, Codex integration, and secret-scanning behavior.

Funes has the clearest fit among memory tools when the data already lives in coding-agent transcripts and local operation is the default. Mem0 and Letta target application or agent architecture, while QMD searches ordinary document collections. Funes asks for patience during a 773-second build and care around remote retention, then repays that cost with focused integrations, unusually candid security docs, and a complete 554-test pass in our run.

Alternatives

ProjectWhat it isPick it when
Mem0 gh↗A memory layer for agents and applications with local and hosted deployment choices.pick this instead when you are building memory into an application rather than indexing coding-agent transcripts.
LettaA platform for stateful agents that manage persistent memory as part of the agent runtime.pick this instead when you want to build and operate the stateful agent itself, not add recall to existing coding tools.
QMDA local command-line search engine for documents, notes, and knowledge bases.pick this instead when the source material is a folder of documents rather than structured agent-session traces.

What people are saying

  1. [github-trending] huggingface/funes

Sources

  1. Funes repository
  2. Funes README at measured commit
  3. Funes agent integration guide
  4. Funes publishing and secret-scanning guide
  5. Funes security policy
  6. Funes v1.3.0 release
  7. Funes Windows support issue
  8. Funes Cline and OpenCode integration request

More llm tools reviews

agentic-api · codex-with-chatgpt · skills · axonhub · supermemory · book-to-skill · the whole board →