Metadata-Version: 2.4
Name: z4j
Version: 2026.4.0a1
Summary: z4j - open-source control plane for Python task infrastructure
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: Apache-2.0
License-File: LICENSE
Keywords: celery,control-plane,dashboard,django,flower,monitoring,queue,task,worker,z4j
Classifier: Development Status :: 3 - Alpha
Classifier: Framework :: Celery
Classifier: Framework :: Django
Classifier: Framework :: FastAPI
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: System Administrators
Classifier: License :: OSI Approved :: Apache Software License
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: z4j-brain
Requires-Dist: z4j-core
Provides-Extra: all
Requires-Dist: asyncpg>=0.30; extra == 'all'
Requires-Dist: z4j-celery; extra == 'all'
Requires-Dist: z4j-django; extra == 'all'
Provides-Extra: celery
Requires-Dist: z4j-celery; extra == 'celery'
Provides-Extra: django
Requires-Dist: z4j-django; extra == 'django'
Provides-Extra: dramatiq
Requires-Dist: z4j-dramatiq; extra == 'dramatiq'
Provides-Extra: fastapi
Requires-Dist: z4j-fastapi; extra == 'fastapi'
Provides-Extra: flask
Requires-Dist: z4j-flask; extra == 'flask'
Provides-Extra: postgres
Requires-Dist: asyncpg>=0.30; extra == 'postgres'
Provides-Extra: rq
Requires-Dist: z4j-rq; extra == 'rq'
Description-Content-Type: text/markdown

# z4j

**Open-source control plane for Python task infrastructure.**

A modern, enterprise-grade replacement for Flower. Monitor, manage, and control your Celery workers, tasks, schedules, and queues from a single dashboard.

## Install

```bash
# Basic (brain server with SQLite)
pip install z4j

# With Celery support
pip install z4j[celery]

# Full Django + Celery stack
pip install z4j[django,celery]

# Production (Postgres backend)
pip install z4j[django,celery,postgres]
```

## Quick start

```bash
# Start the brain server
z4j-brain serve --port 8080 --admin-email you@dev.local --admin-password changeme

# Open http://localhost:8080
```

Add to your Django project:

```python
# settings.py
INSTALLED_APPS += ['z4j_django']
Z4J_BRAIN_URL = "http://localhost:8080"
```

## Docker

```bash
# Single container (evaluation)
docker run -p 8080:8080 z4j/z4j

# Production (Postgres)
docker compose up
```

## Links

- [Documentation](https://z4j.dev/docs)
- [GitHub](https://github.com/z4jc/z4j)
- [Changelog](https://github.com/z4jc/z4j/blob/main/CHANGELOG.md)

## License

- Agent packages (z4j-core, z4j-celery, z4j-django, etc.): **Apache 2.0**
- Brain server (z4j-brain): **AGPL v3** (commercial license available)
