How socraticsurge/telugu-calendar-utilities works
Telugu Panchangam is both a city-specific calendar-feed generator and a daily astrology toolkit exposed through a browser UI and an MCP server. Users select a city, date, and calculation system to view Panchangam details or subscribe to an ICS feed; they can also search activity-aware muhurta windows, assess personal tarabalam, and explore gochara readings. Python calculation engines produce shared day facts for feed generation and MCP tools, while the TypeScript application coordinates browser panels and profile workflows. The README documents capabilities beyond the sampled source, so those subsystem links are shown only where the documentation supports them.
Main entry points: main.ts Browser application · tools.py MCP tools · muhurta_search.py Muhurta search · base.py Engine day assembly
Components 27
Browser toolkit
- Browser application
src/main.ts - Today's Panchangam
src/panels/today.ts - Gochara panel
src/panels/gochara.ts - Guest profiles
src/panels/profiles.ts - Profile store
src/lib/guest-profile-store.ts - Tarabalam and muhurta
src/panels/tarabalam.ts - Muhurta search UI
src/panels/muhurta-search.ts - Muhurta day pipeline
src/panels/muhurta-day-pipeline.ts - Muhurta scoring
src/panels/muhurta-scoring.ts - Chart screening
src/scorer/election-chart-screening.ts
Calendar calculation
- Engine day assembly
telugu_panchangam/engines/base.py - Drik engine
telugu_panchangam/engines/drik.py - Surya Siddhanta engine
telugu_panchangam/engines/surya_siddhanta.py - Vakya engine
telugu_panchangam/engines/vakya.py - Panchangam day facts
telugu_panchangam/models/panchangam_day.py - Panchanga Shuddhi
telugu_panchangam/panchanga_shuddhi.py
Personal astrology
- Muhurta search
telugu_panchangam/personal/muhurta_search.py - Activity rules
telugu_panchangam/personal/activity_rules.py - Personal election
telugu_panchangam/personal/personal_election.py
Feeds and services
- ICS feed generation
telugu_panchangam/generators/ics.py - Feed generation entry
telugu_panchangam/generate.py
MCP interface
- MCP server
telugu_panchangam/mcp/server.py - MCP tools
telugu_panchangam/mcp/tools.py
Other components
- Calendar user
- MCP client
- Chart calculation service
- Calendar applications
Connections 29
- Calendar user → Browser application: uses
README.md - Browser application → Today's Panchangam: loads and renders
src/main.ts - Browser application → Gochara panel: loads
src/main.ts - Browser application → Tarabalam and muhurta: renders
src/main.ts - Browser application → Guest profiles: initializes
src/main.ts - Browser application → Profile store: creates
src/main.ts - Guest profiles → Profile store: uses
- Tarabalam and muhurta → Muhurta search UI: renders
- Muhurta search UI → Muhurta day pipeline: coordinates
src/panels/muhurta-search.ts - Muhurta day pipeline → Muhurta scoring: uses
src/panels/muhurta-day-pipeline.ts - Muhurta scoring → Chart screening: screens candidates
src/panels/muhurta-scoring.ts - Chart screening → Chart calculation service: requests chart
- Drik engine → Engine day assembly: uses base
telugu_panchangam/engines/base.py - Surya Siddhanta engine → Engine day assembly: uses base
- Vakya engine → Engine day assembly: uses base
- Engine day assembly → Panchangam day facts: assembles facts
telugu_panchangam/engines/base.py - Panchangam day facts → Panchanga Shuddhi: assessed by
telugu_panchangam/panchanga_shuddhi.py - Muhurta search → Drik engine: calculates days
telugu_panchangam/personal/muhurta_search.py - Muhurta search → Activity rules: loads rules
telugu_panchangam/personal/muhurta_search.py - Muhurta search → Panchangam day facts: collects results
telugu_panchangam/personal/muhurta_search.py - Calendar user → Calendar applications: subscribes
README.md - Feed generation entry → ICS feed generation: generates feeds
README.md - ICS feed generation → Panchangam day facts: formats day facts
telugu_panchangam/generators/ics.py - ICS feed generation → Calendar applications: provides ICS
README.md - MCP client → MCP server: connects
README.md - MCP server → MCP tools: dispatches tools
telugu_panchangam/mcp/server.py - MCP tools → Drik engine: calculates calendar
telugu_panchangam/mcp/tools.py - MCP tools → Muhurta search: searches muhurtas
telugu_panchangam/mcp/tools.py - MCP tools → Personal election: offers personal tools