uses-llm

Simple Bun static site + API for asking LLM questions over indexed /uses pages.

Stack

• Bun server (Bun.serve)
• SQLite (bun:sqlite) with FTS5
• OpenAI embeddings + chat completion
• Hybrid retrieval (FTS + cosine vector + RRF)
• LLM-driven context screening + answer verification
• Tailwind CSS static UI

1) Install

bun install
cp .env.example .env

Set OPENAI_API_KEY in .env. Optional: set OPENAI_VERIFY_MODEL / OPENAI_SCREEN_MODEL to tune verification and screening stages.

2) Build CSS

bun run build:css

3) Seed index

bun run seed
# or smoke test first
bun run seed:smoke

Useful seed flags:

SEED_LIMIT=50 bun run seed
SEED_CONCURRENCY=3 FETCH_TIMEOUT_MS=20000 bun run seed

4) Run app

bun run dev

Open http://localhost:3000.

API

• GET /api/health
• GET /api/stats
• POST /api/ask body: { "question": "..." }

Notes

• Seed source is https://uses.tech/ and parsed from the embedded Remix loader data.
• If a page cannot be fetched, it is stored as fetch_status=error in pages.