Zeph
Memory-first AI agent with graph memory that runs locally or via cloud providers.
Tested on Linux
Use it
Linux x86_64
You need first
- Runtimes:
Rust>=1.98 - Keys or accounts: provider API keys
Download musl binary and checksum, verify
mkdir -p /tmp/zd && cd /tmp/zd && curl -fsSL -O https://github.com/bug-ops/zeph/releases/download/v0.22.5/zeph-x86_64-unknown-linux-musl.tar.gz && curl -fsSL -O https://github.com/bug-ops/zeph/releases/download/v0.22.5/zeph-x86_64-unknown-linux-musl.tar.gz.sha256 && sha256sum -c zeph-x86_64-unknown-linux-musl.tar.gz.sha256Extract and install binary on PATH
tar xzf /tmp/zd/zeph-x86_64-unknown-linux-musl.tar.gz -C /tmp/zd && chmod 0755 /tmp/zd/zeph && mkdir -p ~/.zeph/bin ~/.local/bin && mv /tmp/zd/zeph ~/.zeph/bin/zeph && ln -sf ~/.zeph/bin/zeph ~/.local/bin/zeph
Where the README and reality differ
- README: curl -fsSL .../latest/download/install.sh | sh installs on Linux x86_64
What worked: download zeph-x86_64-unknown-linux-musl.tar.gz + .sha256, verify, extract and symlink into ~/.local/bin
Check that it works
zeph --versionThe output should contain “zeph 0.22.5”.
First thing to try
mkdir -p ~/.local/bin && ln -sf ~/.zeph/bin/zeph ~/.local/bin/zeph && export PATH="$HOME/.local/bin:$HOME/.zeph/bin:$PATH" && zeph doctorRun zeph doctor first to check that your setup is ready.
What it does
- Recall why past decisions were madeNot shown working
- Read files and run commandsNot tested
- Run long jobs with sub-agentsNot tested
- Send tasks to the cheapest capable providerNot shown working
How far pickfit got
Linux x86_64
- Installs
- Starts
- 0 of 4 features work
- Works offline
macOS and Windows: the project says it runs there; pickfit hasn’t tried it.
Good for
- code with full project context in a repo
- deploy as team chat bot in Telegram Discord Slack
- run privately 100% locally with Ollama
- run long research loops and document RAG jobs
- ingest documents into semantic memory
How pickfit tested it
Each run starts from a clean machine and follows the steps above. How pickfit verifies
Linux x86_64
Its main function works
- Replayed from scratch
- Works offline
- Checked on 30 Oct 2026
- Version 0.22.5
Differences the test machine hit
- README: install.sh downloads and verifies zeph tarball
In the test: install.sh fetches a prebuilt binary tarball which cannot be read as a script before running