Transcript Brief Generator

Paste a raw discovery call transcript, choose a mode, and get a structured client brief — displayed in the browser and downloadable as plain text.

Setup

1. Clone and install dependencies

git clone <your-repo-url>
cd transcript-brief-generator
python -m venv venv
source venv/bin/activate        # Windows: venv\Scripts\activate
pip install fastapi uvicorn anthropic python-dotenv

2. Add your API key

cp .env.example .env
# Edit .env and replace the placeholder with your Anthropic API key

3. Run

uvicorn main:app --reload

Open http://localhost:8000 in your browser.

---

How to use

1. Paste a raw transcript into the text box
2. Choose a mode:
   • Standard — produces the operational brief only
   • My Lens — produces the operational brief plus a deeper framework layer
3. Click Generate Brief
4. View the brief in the browser or click Download .txt to save it

---

How to make it yours

Open config.py. It has two clearly labeled sections:

Section 1: Operational Framework

OPERATIONAL_FIELDS = [
    "[YOUR FRAMEWORK FIELD 1]",
    ...
]

Replace each placeholder with the field names from your diagnostic framework. These appear in both Standard and My Lens mode.

Section 2: My Lens Layer

MY_LENS_QUESTIONS = [
    "[YOUR LENS QUESTION 1]",
    ...
]

Replace each placeholder with the deeper questions from your proprietary framework. These appear only in My Lens mode, after the operational brief.

Add or remove items from either list freely. The prompt is built dynamically from whatever is in these two lists.

---

Run tests

pip install pytest
pytest tests/

Tests use mocked API responses — no real API calls are made.