Metadata-Version: 2.4
Name: z4j-brain
Version: 2026.4.0a1
Summary: z4j brain - server, dashboard, and API (AGPL v3)
Project-URL: Homepage, https://z4j.com
Project-URL: Source, https://github.com/z4jdev/z4j
Project-URL: Documentation, https://z4j.com/docs
Project-URL: Issues, https://github.com/z4jdev/z4j/issues
Project-URL: Changelog, https://github.com/z4jdev/z4j/blob/main/CHANGELOG.md
Author: z4j contributors
License: AGPL-3.0-or-later
License-File: LICENSE
Keywords: brain,celery,control-plane,task,z4j
Classifier: Development Status :: 2 - Pre-Alpha
Classifier: Framework :: FastAPI
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: System Administrators
Classifier: License :: OSI Approved :: GNU Affero General Public License v3 or later (AGPLv3+)
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Classifier: Topic :: System :: Distributed Computing
Classifier: Topic :: System :: Monitoring
Classifier: Topic :: System :: Systems Administration
Classifier: Typing :: Typed
Requires-Python: >=3.13
Requires-Dist: aiosqlite>=0.21
Requires-Dist: alembic>=1.14
Requires-Dist: argon2-cffi>=23.1
Requires-Dist: fastapi>=0.135
Requires-Dist: httpx>=0.28
Requires-Dist: itsdangerous>=2.2
Requires-Dist: openpyxl>=3.1
Requires-Dist: prometheus-client>=0.21
Requires-Dist: pydantic-settings>=2.6
Requires-Dist: pydantic[email]>=2.9
Requires-Dist: python-multipart>=0.0.18
Requires-Dist: sqlalchemy[asyncio]>=2.0.45
Requires-Dist: structlog>=25.1
Requires-Dist: uvicorn[standard]>=0.32
Requires-Dist: websockets>=14
Requires-Dist: z4j-core
Provides-Extra: otel
Requires-Dist: opentelemetry-api>=1.28; extra == 'otel'
Requires-Dist: opentelemetry-exporter-otlp>=1.28; extra == 'otel'
Requires-Dist: opentelemetry-instrumentation-fastapi>=0.49b2; extra == 'otel'
Requires-Dist: opentelemetry-sdk>=1.28; extra == 'otel'
Provides-Extra: postgres
Requires-Dist: asyncpg>=0.30; extra == 'postgres'
Provides-Extra: test
Requires-Dist: aiosqlite>=0.21; extra == 'test'
Requires-Dist: freezegun>=1.5; extra == 'test'
Requires-Dist: httpx>=0.28; extra == 'test'
Requires-Dist: hypothesis>=6.120; extra == 'test'
Requires-Dist: pytest-asyncio>=0.24; extra == 'test'
Requires-Dist: pytest-cov>=6.0; extra == 'test'
Requires-Dist: pytest>=8.3; extra == 'test'
Provides-Extra: test-integration
Requires-Dist: psycopg[binary]>=3.2; extra == 'test-integration'
Requires-Dist: testcontainers[postgres]>=4.9; extra == 'test-integration'
Description-Content-Type: text/markdown

# z4j-brain

**License:** AGPL v3 (see [`../../LICENSE-AGPL`](../../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
`licensing@z4j.dev`.

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`](../../docs/CLAUDE.md) 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`](../../docs/BACKEND.md) — backend spec
- [`docs/FRONTEND.md`](../../docs/FRONTEND.md) — dashboard spec
- [`docs/DATABASE.md`](../../docs/DATABASE.md) — Postgres schema
- [`docs/API.md`](../../docs/API.md) — REST API + WebSocket protocol
- [`docs/DEPLOYMENT.md`](../../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.
