Release v0.1.0 – Initial Public Release

Release Date: 2026-01-08

Highlights:

• Initial public release of Plutus, a scalable, idempotent, async event ingestion and processing system.

• Provides FastAPI API endpoints for event ingestion.

• Includes async SQLAlchemy integration for PostgreSQL.

• Background worker architecture for sequential, reliable event processing.

• Built-in observability with Prometheus metrics and OpenTelemetry tracing.

• Dockerized deployment with Docker Compose for API, worker, and DB services.

• Fully documented OSS setup, including:

  • README.md

  • ARCHITECTURE.md

  • SECURITY.md (with threat model & GitHub advisory workflow)

  • CONTRIBUTING.md, SUPPORT.md, CODE_OF_CONDUCT.md

  • PULL_REQUEST_TEMPLATE.md, ISSUE_TEMPLATEs (bug, feature, security)

  • CHANGELOG.md for version history

  • GitHub Actions CI/CD and Dependabot for dependency updates

Changelog Summary (v0.1.0):

• Implemented event ingestion API (POST /api/v1/ingest)

• Created background worker for RawEvent processing

• Added idempotency key handling

• Configured async PostgreSQL session management

• Integrated OpenTelemetry tracing spans for worker & API

• Added Prometheus metrics endpoint (GET /metrics)

• Initial Docker and Docker Compose setup

Notes for Users:

• Requires PostgreSQL and Redis for full functionality.

• Rate limiting and abuse prevention should be handled at the edge (API gateway or reverse proxy).

• Designed for exactly-once semantics in event processing.

• For production deployments, configure OTLP_ENDPOINT if using OpenTelemetry exporters.

How to Upgrade:

• This is the first public release; no prior versions exist.

• Use Docker Compose or direct Python execution:

docker compose up --build
# or
python -m app.main   # start API
python -m workers.consumer  # start worker

Known Issues / Limitations:

• No built-in rate limiting (see SECURITY.md for recommendations).

• Initial release; no multi-worker sharding or distributed processing yet.