Harvest exposes an AI-powered HTTP API and web interface for querying code knowledge graphs stored in Neo4j. Agents can connect to it to run commands on remote machines.
Prerequisites ───────────── A running Neo4j instance (not bundled in this snap).
Quick start ───────────
Set required credentials:
snap set harvest
neo4j.password=<neo4j-password>
llm.primary.provider=anthropic
llm.primary.api-key=<llm-api-key>
auth.jwt-secret=$(openssl rand -base64 32)
Start the services: snap start harvest.serve snap start harvest.ui
Open http://localhost:3000 in your browser.
Snap configuration keys ─────────────────────── neo4j.host Neo4j hostname (default: localhost) neo4j.port Neo4j bolt port (default: 7687) neo4j.user Neo4j username (default: neo4j) neo4j.password Neo4j password (required) server.host API bind address (default: 127.0.0.1) server.port API port (default: 8080)
LLM providers — define any number with user-chosen names: llm.<name>.provider anthropic | gemini | openai-compatible llm.<name>.api-key API key (setting this enables the provider) llm.<name>.model Model name llm.<name>.base-url Base URL (openai-compatible only) llm.<name>.timeout-secs Per-request timeout (default: 120) llm.<name>.max-retries Retry limit per request (default: 3) llm.<name>.priority Lower = tried first on rate limits (default: 0)
Example — Anthropic primary, Gemini fallback:
snap set harvest
llm.primary.provider=anthropic llm.primary.api-key=sk-ant-...
llm.fallback.provider=gemini llm.fallback.api-key=AIza...
llm.fallback.priority=1
agent.max-iterations Agent iteration limit (default: 20) agent.compaction-threshold-chars Context compaction trigger (default: 40000) agent.compaction-keep-last Messages kept after compaction (default: 6) auth.jwt-secret JWT signing secret (required) auth.allow-local-login Enable username/password login (default: true) auth.google.client-id Google OAuth client ID (optional) auth.google.client-secret Google OAuth client secret (optional) auth.google.redirect-uri Google OAuth redirect URI (optional) auth.oidc.issuer-url OIDC provider URL (optional) auth.oidc.client-id OIDC client ID (optional) auth.oidc.client-secret OIDC client secret (optional) auth.oidc.redirect-uri OIDC redirect URI (optional) auth.oidc.display-name OIDC provider display name (optional) agents.public-url Public URL for agent callbacks (optional) docs.dir Documentation directory (default: $SNAP_COMMON/docs) ui.enable-docs Show docs page in web UI (default: false) ui.host Web UI bind address (default: 127.0.0.1) ui.port Web UI port (default: 3000)
Thank you for your report. Information you provided will help us investigate further.
There was an error while sending your report. Please try again later.
Snaps are applications packaged with all their dependencies to run on all popular Linux distributions from a single build. They update automatically and roll back gracefully.
Snaps are discoverable and installable from the Snap Store, an app store with an audience of millions.
Snap can be installed from the command line on openSUSE Leap 15.x and Tumbleweed.
You need first add the snappy repository from the terminal. Choose the appropriate command depending on your installed openSUSE flavor.
Tumbleweed:
sudo zypper addrepo --refresh https://download.opensuse.org/repositories/system:/snappy/openSUSE_Tumbleweed snappy
Leap 15.x:
sudo zypper addrepo --refresh https://download.opensuse.org/repositories/system:/snappy/openSUSE_Leap_15.6 snappy
If needed, Swap out openSUSE_Leap_15. for, openSUSE_Leap_16.0 if you’re using a different version of openSUSE.
With the repository added, import its GPG key:
sudo zypper --gpg-auto-import-keys refresh
Finally, upgrade the package cache to include the new snappy repository:
sudo zypper dup --from snappy
Snap can now be installed with the following:
sudo zypper install snapd
You then need to either reboot, logout/login or source /etc/profile to have /snap/bin added to PATH.
Additionally, enable and start both the snapd and the snapd.apparmor services with the following commands:
sudo systemctl enable --now snapd
sudo systemctl enable --now snapd.apparmor
To install harvest, simply use the following command:
sudo snap install harvest --edge
Browse and find snaps from the convenience of your desktop using the snap store snap.
Interested to find out more about snaps? Want to publish your own application? Visit snapcraft.io now.