# AI Content Pipeline

Dockerized monorepo foundation for the AI Content Pipeline.

## Local Development

Start the full stack from the repository root:

```sh
make dev
```

Equivalent command:

```sh
docker compose up --build
```

The stack exposes:

| Service | URL |
| --- | --- |
| Frontend | `http://localhost:3000` |
| Backend | `http://localhost:8000` |
| Runner | `http://localhost:8010` |
| MinIO console | `http://localhost:9001` |

Local-only defaults are documented in `.env.example`. Copy it to `.env` only when
you need to override local ports or service credentials.

## Health Smoke

Run the public health smoke test:

```sh
make smoke
```

The smoke test starts Docker Compose, checks frontend/backend/runner health
endpoints, and verifies that the backend can connect to Postgres, Redis, and
S3-compatible object storage.

## End-to-End Demo

Run full deterministic demo stack:

```sh
docker compose up --build
```

The Compose profile is configured for demo mode and does not require external
credentials for Codex/search/WHOIS/cloud storage/GitHub.

Detailed steps (roles, happy path, failure/retry path, artifact inspection):

- [Demo Stack Guide](docs/demo-stack-guide.md)