8fs - Local Pinecone Alternative (SQLite Vector HTTP API)

A simple HTTP API for sqlite-vec.

What it does

• Stores and searches vectors via REST API
• Uses SQLite for persistence
• Includes S3-compatible file storage

Why it exists

I needed a local alternative to Pinecone. Maybe you do too.

Installation

Docker (Recommended)

# Docker Hub
docker run -p 8080:8080 melihbirim/8fs:latest

# GitHub Container Registry (after PR merge)
docker run -p 8080:8080 ghcr.io/8fs-io/8fs:latest

From Source

git clone https://github.com/8fs-io/core.git
cd core
go build ./cmd/server
./server

Usage

Store a vector

curl -X POST http://localhost:8080/api/v1/vectors/embeddings \
  -H "Content-Type: application/json" \
  -d '{"id": "doc1", "embedding": [0.1, 0.2, 0.3], "metadata": {"title": "test"}}'

Search vectors

curl -X POST http://localhost:8080/api/v1/vectors/search \
  -H "Content-Type: application/json" \
  -d '{"query": [0.1, 0.2, 0.3], "top_k": 5}'

Store files (S3-compatible)

curl -X PUT http://localhost:8080/my-bucket/file.txt \
  -d "Hello World"

Configuration

Set environment variables:

• PORT=8080 - Server port
• STORAGE_PATH=./data - Data directory
• VECTOR_DIMENSION=384 - Vector dimensions

License

MIT