Skip to content

guykhazma/agora

Repository files navigation

Agōra

Agōra

One place for everything happening in an open-source project.

See it in action  •  Architecture


Why Agōra?

The agora (ἀγορά) was the central public square of ancient Greek cities — where citizens gathered to trade, debate, vote, and govern. Every major decision passed through the agora.

Open-source communities have the same problem as a city without a town square: debates happen simultaneously in GitHub issues, mailing list threads, design docs, and video calls, with no single place to see what is actually being decided.

Agōra is that town square. It crawls GitHub, mailing lists, YouTube, and linked Google Docs, then surfaces a unified dashboard showing what's being proposed, what's gaining traction, what needs a vote, and which discussions across different channels are about the same thing.


What you get

Overview — the pulse of the project at a glance:

  • AI-generated digest of what's been active
  • Last community sync notes with summary
  • Upcoming community events with Join links
  • Recent votes with pass/veto status
  • Recent activity feed

Initiatives — cross-source topic clusters ranked by how many channels are engaged, grouped by stage: Vote · In Design · Cross-Source · Active

Feed — filterable stream of every item: votes, RFCs, PRs, discussions, announcements, videos, releases, milestones

Docs — design documents and Google Docs extracted from discussions, grouped by topic and sorted by date


Currently tracking

Project Sources
Apache Iceberg GitHub issues, PRs & discussions · dev@ mailing list · YouTube community syncs · Releases & milestones · Community calendar

Want to add a project? It's one YAML file.


Adding a project

  1. Copy projects/iceberg.yaml as projects/<your-project>.yaml
  2. Fill in the fields — at minimum id, name, repo, and one source
  3. Open a PR — the next crawl will populate it automatically

Minimal config:

id: my-project
name: My Project
repo: apache/my-project
mailing_list:
  address: dev@my-project.apache.org
  pony_mail_list: dev
  pony_mail_domain: my-project.apache.org
  history_start: "2024-01"   # full backfill from this month when state is empty / --reset

For all available fields and how the pipeline works, see ARCHITECTURE.md.


License

Apache 2.0

About

Open-source town hall

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages