Skip to content
Chethan Yadav
Work

Open Source/2025/Active

Hyderabad Tech Events

A crowdsourced, auto-updated list of tech meetups and startup events happening in Hyderabad.

Python
Repository

Overview

hyderabad-tech-events isn't a typical piece of software — it's a git repository doing double duty as a database and a publishing pipeline. The single source of truth is data/events.json; everything else — the README's event tables, data validation, republishing — is generated or enforced by GitHub Actions on top of it. The goal is one crowdsourced, always-current list of tech meetups and startup events in Hyderabad that anyone can read without digging through half a dozen dead Meetup groups, and that anyone can extend with a GitHub issue instead of asking someone to update a spreadsheet by hand.

There's also a companion Telegram channel (@eventshyderabad) that notifies subscribers the moment a new event lands in the data file.

Key Features

  • JSON as the database — every event is a plain object in data/events.json (name, link, location, datetime, optional end_time); no backend, no admin panel
  • Auto-generated README — scripts/generate_readme.py renders data/events.json into the Upcoming/Past Events tables in the README; a scheduled workflow (update_readme.yml) re-runs it daily so the list never goes stale on its own
  • PR validation — validate.yml checks JSON syntax, schema, and duplicates on every pull request before a human reviews it; markdown-lint.yml enforces markdown quality on the generated output
  • Two ways to contribute — a GitHub Issue form for non-developers ("Add Event"), or a direct pull request against data/events.json for anyone comfortable with git
  • Curated community directory — alongside events, the README maintains a hand-picked list of Hyderabad tech communities (HydPy, React Hyderabad, GDG Hyderabad, AWS User Group Hyderabad, Kubernetes Over Koffee, and others) with a short description of what each one covers

Contributing an Event

Via issue: open Issues → "Add Event" and fill out the form.

Via pull request:

# Fork, then:
git clone https://github.com/YOUR_USERNAME/hyderabad-tech-events.git
cd hyderabad-tech-events
git checkout -b add-event

Edit data/events.json with this shape:

{
  "name": "Your Event Name",
  "link": "https://event-url.com",
  "location": "Hyderabad, India",
  "datetime": "2026-01-20 18:00",
  "end_time": "2026-01-20 20:00"
}
python3 scripts/generate_readme.py   # optional: preview the rendered README locally
git add data/events.json
git commit -m "Add Event: Your Event Name"
git push origin add-event

Events are accepted if they're tech-related (software, AI/ML, startups, cloud, etc.), located in Hyderabad, link to a valid event page, and are in the future — no spam or duplicates. Submissions are typically reviewed within 24-48 hours.

How It Works

data/events.json  →  scripts/generate_readme.py  →  README.md

A contributor edits data/events.json, by hand or via the issue form (which a maintainer then transcribes into the file). On a pull request, validate.yml runs automated checks — JSON syntax, schema conformance, duplicate detection — so bad data doesn't reach main. Once merged, update_readme.yml runs daily, regenerates the README's Upcoming and Past Events tables from whatever events.json currently contains, and commits the result — so "Upcoming Events" always reflects today's date without anyone manually pruning events that already happened.

View on GitHub ↗ · Telegram channel ↗