beauforce/circular-value-chain

Circulaire Keten Generator — ONHN

Wat is dit? Een matching-tool waarmee ketenregisseurs en innovatieve mkb'ers een circulaire waardeketen kunnen bouwen rondom hun eigen vraagstuk. De tool koppelt 4 099 regionale en bovenregionale bedrijven aan rollen in de keten via hybride embedding-similarity + LLM-reranking.

Voor wie? Ketenregisseurs (gemeenten, ontwikkelingsbedrijven, adviseurs) en mkb'ers die schakels zoeken voor een circulaire samenwerking in Noord-Holland Noord.

Output? Een exporteerbaar PDF-dossier met gematchte partijen per rol, gap-analyse en kennispartners — geschikt voor pitch, financieringsaanvraag of uitnodigingsmail.

Lokaal draaien

Vereisten: Python 3.11+, pip, een Anthropic API-key.

# 1. Clone en installeer
git clone <repo-url>
cd keten-generator-backend
pip install -r requirements.txt

# 2. Zet je API-key
cp .env.example .env
# Vul ANTHROPIC_API_KEY in .env in

# 3. Start de backend
uvicorn app.main:app --reload --port 8000

# 4. Open in browser
open http://localhost:8000

De frontend wordt automatisch geserveerd op GET / — geen aparte build-stap nodig.

Ketens

Architectuur

Zie ARCHITECTURE.md voor een volledig overzicht van endpoints, datamodellen en bekende technische schulden.

Deployment

Zie DEPLOY.md voor instructies voor Hugging Face Spaces.