eventa 0.1.0

Lightweight, local-first event analytics SDK for Python applications

Eventa

Lightweight, local-first event analytics for Python applications — no external services required.

from eventa import Analytics

analytics = Analytics(database="sqlite:///eventa.db")

analytics.track(
    event="payment_success",
    user="telegram:123456",
    properties={"plan": "premium", "price": 299},
)

Install

pip install eventa

Usage

from eventa import Analytics

analytics = Analytics()  # defaults to sqlite:///eventa.db

analytics.track(event="login", user="user_123")
analytics.track(event="button_click", user="user_123", properties={"button": "buy"})

analytics.count_events()                 # total events
analytics.count_events(event="login")    # events of a given name

user is just a string identifier you control — Eventa doesn't manage user accounts or profiles. Events are stored in their own eventa_events table, so Eventa never touches your application's existing models or migrations.

Storage

Any SQLAlchemy connection URL works:

analytics = Analytics(database="sqlite:///eventa.db")

SQLite is supported today; other SQL databases (e.g. PostgreSQL) work through the same mechanism once tested and documented.

Development

uv sync --extra dev
uv run pytest
uv run ruff check .
uv run mypy

License

MIT