funes

Your machine's memory, queryable.

You fixed a weird Postgres bug 3 months ago. You remember it was something with deadlocks. You have no idea which file, which project, or what the fix was.

funes remembers.

It runs quietly in the background, indexes your files, notes, and terminal history, and lets you ask questions in plain English to find anything you've ever worked on.

funes query "that postgres deadlock fix"

funes query "what was I working on last Tuesday"

funes query "the nginx config that fixed the 502s"

No cloud. No account. No subscription. Everything stays on your machine.

How It Works

funes watches your files and shell history, breaks them into chunks, and turns each chunk into a vector embedding using a local AI model. When you search, it finds the chunks that are closest in meaning to your question — not just keyword matches, but actual semantic understanding.

your files -> chunker -> embedder -> local database -> query -> answer

All of this runs locally using Ollama. Your data never leaves your machine.

install

Requirements: Rust and Ollama

Requirements

• Rust
• Ollama

# Pull the models funes needs

ollama pull nomic-embed-text

ollama pull llama3


# Install funes

cargo install funes

Usage

funes start                    # Start the background daemon

funes add ~/notes              # Manually index a folder

funes watch ~/projects         # Watch a folder for changes

funes query "something you remember vaguely"

funes query "..." --llm        # Get a plain English answer instead of raw results

funes status                   # See what's indexed

funes forget "*.env"           # Exclude sensitive files

Why Funes?

Jorge Luis Borges wrote a short story in 1942 called Funes the Memorious — about a man who forgets nothing. Every detail of his life, perfectly preserved and instantly recallable.

That's the goal here. Not quite perfect memory, but close enough to be useful.

Roadmap & Status

funes is early and under active development. Things will break. Contributions are very welcome.

• CLI skeleton
• Ollama embeddings working
• SQLite / vector storage
• File watcher
• Shell history indexing
• Query with results
• LLM synthesis mode
• Packaging (Homebrew, Cargo)

License

This project is licensed under the MIT License. See the LICENSE file for details.

Contributing

We welcome contributions to help build out the roadmap. See CONTRIBUTING.md for details.