Getting Started

The fastest way to try event7 is the self-hosted Docker deployment — everything runs locally in 5 minutes. The hosted demo is offline for now; a live walkthrough can be arranged on request.

Recommended

Self-Hosted (Docker)

Full stack on your machine — frontend, backend, Apicurio, PostgreSQL, Redis. No account needed, no limits, full control.

Installation guide →
Offline for now

SaaS (Hosted Demo)

The hosted demo is not running at the moment. A live walkthrough can be arranged on request. Multi-tenant isolation and self-service signup are in progress.

Request a walkthrough →

Self-Hosted Quick Start

1

Clone and configure

git clone https://github.com/KTCrisis/event7.git
cd event7

# Generate an encryption key
python -c "from cryptography.fernet import Fernet; print(Fernet.generate_key().decode())"

# Copy and edit the env file
cp backend/.env.example backend/.env

Set ENCRYPTION_KEY and DB_PROVIDER=postgresql in backend/.env. See the full installation guide for all options.

2

Start the stack

docker compose -f docker-compose.local.yml up -d --build

# Services started:
#   localhost:3000  → Frontend (Next.js)
#   localhost:8000  → Backend API (FastAPI)
#   localhost:8081  → Apicurio Registry v3
#   postgres:5432   → PostgreSQL 15
#   redis:6379      → Redis 7
3

Connect the registry

Open http://localhost:3000/settings and connect the local Apicurio: http://apicurio:8080 (the Docker internal hostname).

4

(Optional) Seed with sample data

cd backend
pip install requests pyyaml   # if not already installed

# Seed Apicurio with 11 schemas + cross-references (7 Avro, 2 JSON, 2 Protobuf)
python scripts/seed_apicurio.py --url http://localhost:8081

# Seed event7 with enrichments, channels, bindings, and rules
python scripts/seed_event7.py --url http://localhost:8000

This creates 11 subjects (7 Avro, 2 JSON Schema, 2 Protobuf) with references, 11 enrichments (4 data layers, 7 teams), 8 channels (Kafka + RabbitMQ + Redis Streams), 11 bindings, and 7 governance rules — a complete demo environment.

5

Verify health

curl http://localhost:8000/health

# Expected:
# {"status": "healthy", "services": {"redis": "ok", "database": "ok"},
#  "database_provider": "PostgreSQLDatabase", "version": "0.1.0"}

SaaS Preview

Offline for now

The hosted version of event7 at event7.flux7.art currently serves this documentation only: its backend is not running, so the application has no data behind it.

To see event7 on a connected registry, use the self-hosted Docker deployment, or reach out for a live walkthrough.

Work in progress: multi-tenant isolation, self-service onboarding, and SSO integration.

Request a walkthrough

Two starting paths

Existing registry with schemas

Connect your registry and event7 discovers all subjects automatically. Then validate new versions before publishing, enrich them in the Catalog (tags, ownership, classification, data layers), create channels manually, and generate AsyncAPI specs.

Connect→Explore→Validate→Enrich→Govern
Empty registry — start with AsyncAPI

Connect an empty registry (e.g. fresh Apicurio), then import an AsyncAPI spec. event7 creates schemas, channels, bindings, and enrichments in one operation. Everything populated from a single YAML/JSON file.

Connect→Import→Done

Next steps