z4j-brain 2026.4.0a1

z4j brain - server, dashboard, and API (AGPL v3)

z4j-brain

License: AGPL v3 (see ../../LICENSE-AGPL) Status: Phase 1 scaffolding — not yet implemented.

The z4j brain: FastAPI backend + TanStack Start v1 dashboard. This is the server half of z4j. Agents connect to it over WebSocket (or HTTPS long-poll fallback) and users interact with it through the dashboard.

Licensing

This package is AGPL v3. If you are an organization whose policy forbids AGPL-licensed code, a commercial license is available — contact [e-mail].

All agent packages (z4j-core, z4j-bare, z4j-django, z4j-celery, etc.) are Apache 2.0 and can be freely imported into proprietary code. See docs/CLAUDE.md §4.4 for the full split-licensing rationale.

What's here

• backend/ — FastAPI application, REST API, WebSocket gateway, persistence layer, domain services, background workers, auth, migrations
• dashboard/ — TanStack Start v1 + React 19.2 + TypeScript 6 dashboard

Documentation

• docs/BACKEND.md — backend spec
• docs/FRONTEND.md — dashboard spec
• docs/DATABASE.md — Postgres schema
• docs/API.md — REST API + WebSocket protocol
• docs/DEPLOYMENT.md — self-host deployment

Tech stack

Python 3.13+, FastAPI 0.135+, SQLAlchemy 2.0.45+ async, PostgreSQL 18.3+, TanStack Start v1, React 19.2, TypeScript 6, Tailwind CSS 4, shadcn/ui, Debian 13 Trixie slim base image.