Installation

Prerequisites

• Python 3.12+
• uv (package manager)
• A Neon Postgres database (or local Postgres via Docker)
• Anthropic API key
• WordPress site with application password

Clone and Install

git clone https://github.com/Tinnitus-App/content-automation.git
cd content-automation
uv sync --all-extras

Local Postgres with Docker

If you don't have a Neon database, spin up a local Postgres instance:

docker compose up -d   # Starts Postgres 16 with pgvector extension

Then run migrations:

uv run alembic upgrade head

Dev Container

A .devcontainer/devcontainer.json is included for VS Code / GitHub Codespaces. It provides:

• Python 3.12 with uv pre-installed
• PostgreSQL client tools
• Port forwarding for Postgres (5432), Streamlit (8501), and Prefect (4200)