Search docs…⌘K
v0.10.0 · MIT

Feather Core is open source. Star us and ship fast.

View on GitHub →
Home/Docs/Installation
Installation

Install Feather DB.

Feather v0.10.0 ships as a native Python binding with a C++ core, a lightning-fast Rust CLI, and the new Cloud Edition Docker image with the Atlas admin SPA. One of the paths below has you running in under 5 minutes.

Cloud Edition (Docker)

New in v0.10

feather-api + Atlas admin SPA

Run the managed-style REST server with the brand-aligned admin SPA at /admin/. One-call ingest_text, pluggable embeddings (OpenAI · Azure · Gemini · Voyage · Cohere · Ollama), ring-buffer observability. Compiles the C++ wheel inside the container — no host toolchain required.

git clone https://github.com/feather-store/feather.git
cd feather

docker compose -f feather-api/docker-compose.yml build

FEATHER_API_KEY="feather-$(openssl rand -hex 16)" \
  docker compose -f feather-api/docker-compose.yml up -d

# health check
curl -sf http://localhost:8000/health
# → {"status":"ok","version":"0.10.10","namespaces_loaded":0}

# admin SPA
open http://localhost:8000/admin/
What you get
  • /admin/Atlas-style SPA — records, search, schema, hierarchy, graph, context, console
  • POST /v1/{ns}/ingest_textembed + store in one call via your configured provider
  • GET /v1/admin/metricsp50/p95/p99 latency + ops counts from the in-memory ring buffer

Python (recommended)

Most popular

Python client

The standard way to integrate Feather into an LLM or embedded vector workflow. Ships wheels for macOS, Linux, and Windows.

pip install feather-db
Requirements
  • Python 3.8+any modern CPython build
  • NumPy 1.22+for vector conversions

Rust CLI

Zero deps

feather CLI

A single static binary for ingestion, debugging, and CI/CD. Compiles fast, drops in anywhere.

cargo install feather-db-cli
# or
curl -sSf https://get.feather.store | sh
Build from source
git clone https://github.com/feather-store/feather.git
cd feather/cli
cargo build --release

JavaScript (beta)

Beta

Node / Bun wrapper

Native bindings via N-API. Works in Node 20+, Bun 1.1+, and Deno (via npm specifier).

pnpm add feather-db
# or
bun add feather-db