Sign inSign up

melihbirim/8fs

By melihbirim

•Updated about 1 year ago

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

Image
API management
Developer tools
0

1.2K

melihbirim/8fs repository overview

⁠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 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

Tag summary

Content type

Image

Digest

sha256:524faffef…

Size

43.5 MB

Last updated

about 1 year ago

docker pull melihbirim/8fs