Use docker-compose.assmold.yml for this fork. The older Compose overlays and historical documentation below describe the upstream HasanAra deployment. Assmold has an independent database, Redis, media/cache storage, sessions, and backups. The launch uses PostgreSQL search, YouTube captions, and a single CPU small-model transcription worker. Discovery runs every six hours. Paid enrichment is disabled; OAuth and donations require separate configuration. Backups run daily into runtime/backups; they are local backups, not off-host disaster recovery.

# On Almaz, the legacy builder can reuse the already-installed dependency images.
DOCKER_BUILDKIT=0 docker build -f Dockerfile.assmold-api --build-arg ASSMOLD_COMMIT="$RELEASE_TAG" -t "assmold-api:$RELEASE_TAG" .
DOCKER_BUILDKIT=0 docker build -f Dockerfile.assmold-worker --build-arg GIT_COMMIT="$RELEASE_TAG" -t "assmold-worker:$RELEASE_TAG" .
docker compose --env-file .env.assmold -f docker-compose.assmold.yml build frontend
docker compose --env-file .env.assmold -f docker-compose.assmold.yml up -d

Export RELEASE_TAG to the intended source commit before the build commands. The private .env.assmold must contain DB_PASSWORD, SESSION_SECRET, ANALYTICS_HMAC_SECRET (independent random values) and RELEASE_TAG (source commit). API/worker Dockerfiles reuse pinned upstream dependency images and package this fork's application source. config/assmold.Caddyfile is imported by the existing Almaz edge Caddy; the wildcard Cloudflare tunnel supplies public HTTPS.

HasanAra

HasanAra is a citation-first HasanAbi VOD archive. It searches timestamped transcripts, groups evidence by episode, and provides topic timelines, opinion-history revisions, related episodes, quoted moments, and portable mention exports.

Outcome

HasanAra turns long-form video into reviewable research: a reader can move from a query to the relevant timestamp, episode context, and supporting excerpts without treating an AI-generated summary as the source of record. It is the deployed, branded successor to the earlier Transcript Create project.

Public signals: deployed application · API contract · Apache-2.0 license · third-party notices

Current status

Shipped: React 19 frontend, FastAPI API, PostgreSQL source of truth, Redis DTO caches, optional OpenSearch acceleration with PostgreSQL fallback, durable ingestion jobs, scoped API keys, pseudonymous analytics, and archive intelligence.
Shipped: public Support/About/Privacy/Terms pages and a validated, Stripe-hosted donation Payment Link that never handles card data in HasanAra.
Disabled: product billing, subscriptions, payment webhooks, and PWA/offline installation. There are no charge-creation routes or service workers.
Historical: documents marked historical describe earlier implementations and are not operational guidance.

See documentation status for the authoritative document map.

Supported development environment

Python 3.11
Node.js 20
Docker with Compose

python3.11 -m venv .venv
.venv/bin/pip install -r requirements-dev.txt
npm --prefix frontend ci
npm --prefix e2e ci
TEST_POSTGRES_PORT=55433 mise exec node@20 -- env PYTHON_BIN="$PWD/.venv/bin/python" make verify

For a fresh local database, copy .env.example, then run ALLOW_SESSION_TOKEN_CONTRACT_MIGRATION=true docker compose up --build. The frontend defaults to http://localhost:5173; the API defaults to http://localhost:8000. This opt-in is for controlled local bootstrap only, not a production rolling upgrade.

Architecture and contracts

/api is v1-stable: changes are additive, deprecations remain for at least two releases, and breaking changes require /api/v2.

Assmold initial qualified release

Latest

2026-09-10 14:25:23 -05:00

Python 68.8%

TypeScript 25.2%

Shell 2.3%

CSS 1.1%

Jupyter Notebook 0.7%

Other 1.8%