---
title: Orsync Scenarist
emoji: 🧠
colorFrom: blue
colorTo: purple
sdk: docker
app_port: 7860
pinned: false
---

# Orsync Scenarist v7.0

Enterprise pharma strategic intelligence platform — FastAPI backend with
knowledge-graph HCP profiling, GMM behavioural clustering, and LLM-powered
campaign optimisation.

## Quick Start (Hugging Face Spaces)

This repo is configured for one-click deployment to
[Hugging Face Spaces](https://huggingface.co/spaces) as a **Docker** Space.

1. Create a new Space on Hugging Face → select **Docker** SDK.
2. Push this repo to the Space repository.
3. (Optional) Set these Secrets in the Space settings for full functionality:

| Secret | Required? | Purpose |
|--------|-----------|---------|
| `OLLAMA_API_KEY` | For LLM features | Ollama Cloud API key for gemma4:31b-cloud |
| `OLLAMA_HOST` | Optional | Ollama Cloud endpoint (default: https://ollama.com) |
| `JWT_SECRET_KEY` | Recommended | Auth token signing (uses dev default if missing) |

Redis, Neo4j, and ChromaDB run **inside the container** automatically — no external services needed.

The app starts on port **7860** and the API docs are at `/docs`.

Without external services the app still boots — Redis, Neo4j, and ChromaDB are
embedded in the container, while RabbitMQ falls back to a no-op stub.

## Local Development

See [SETUP.md](SETUP.md) for detailed step-by-step setup instructions.

## API Docs

Once running: **http://localhost:7860/docs**