funes

your machine's memory, queryable.

indexes your files, notes, and shell history locally. ask questions in plain English. no cloud, no accounts — your data never leaves your machine.

terminal

$funes start

daemon started — watching ~/projects, ~/notes

$funes query "that postgres deadlock fix"

→ src/db/pool.rs [score: 0.94] — set idle_in_transaction_session_timeout = '5s'

$funes query "nginx config for 502s"

→ infra/nginx.conf [score: 0.91] — proxy_read_timeout 300s fixed it

$funes status

indexed: 3,847 chunks · db: 12mb · uptime: 2d 4h

— how it works

three steps. no setup beyond install.

watch

funes runs quietly in the background, monitoring your files, notes, and shell history for changes in real time.

index

every file is chunked and converted into a vector embedding using a local AI model via Ollama. nothing leaves your machine.

query

ask anything in plain English. funes finds the most semantically relevant results across everything you've ever worked on.

— install

$ cargo install funes

requires rust and ollama. see github for full setup instructions.

view source on github

— roadmap

status

8/11 done

funes is early and under active development. things will break. contributions are very welcome.

73% complete

CLI skeleton

basic command structure

Ollama embeddings working

local model integration

SQLite / vector storage

persistent local index

File watcher

live indexing on change

Shell history indexing

bash / zsh / PowerShell support

Query with results

semantic search over index

LLM synthesis mode

plain English answers

Packaging (Cargo)

cargo install funes-memory

Packaging (Homebrew)

one-line install on macOS

Daemon mode

true background process

Docs

full documentation site

want to help build one of these? see CONTRIBUTING.md.