You'll be working with a healthcare transcript processing system. The API already handles storing and retrieving raw transcripts from vendor calls, implementation meetings, and other healthcare-related discussions.
- Docker Desktop
- uv (Python package manager)
- An OpenAI API key (will be provided)
# 1. Start PostgreSQL
docker compose up -d
# 2. Install dependencies
uv sync
# 3. Copy environment file and add your OpenAI API key
cp .env.example .env.local
# Edit .env.local to add your OPENAI_API_KEY
# 4. Run database migrations
make migrate
# 5. Seed the database with transcript files
make seed
# 6. Start the development server
make devThe API will be available at http://localhost:8000.
./verify-setup.shapp/
├── config.py # Settings (DATABASE_URL, OPENAI_API_KEY)
├── database.py # Async SQLAlchemy engine + session
├── main.py # FastAPI app with CORS + routers
├── models/ # SQLAlchemy models
│ ├── transcript.py # Raw transcript storage
│ └── processed_transcript.py # Basic processed data (intentionally simple)
├── schemas/ # Pydantic schemas
│ └── transcript.py # Request/response schemas
└── routers/
├── transcripts.py # GET /api/transcripts, GET /api/transcripts/{id}
└── pipeline.py # POST /api/transcripts/{id}/process (your focus)
lib/
└── llm.py # AsyncOpenAI client (ready to use)
transcripts/ # 11 raw transcript files (loaded by seed.py)
| Method | Path | Description |
|---|---|---|
| GET | /api/transcripts |
List all transcripts |
| GET | /api/transcripts/{id} |
Get transcript with full content |
| POST | /api/transcripts/{id}/process |
Process transcript (your focus) |
| GET | /api/health |
Health check |
| Command | Description |
|---|---|
make dev |
Start development server (port 8000) |
make seed |
Load transcript files into database |
make migrate |
Run database migrations |
make migrate-create name="description" |
Create new migration |
make reset |
Reset database (downgrade + upgrade + seed) |
make install |
Install dependencies |