Telugu Panchangam
Cálculos del almanaque hindú como herramientas MCP: tithi, nakshatra, ventanas de muhurta, más de 30 festivales, búsqueda de días favorables con tarabalam, tránsitos gochara y rasi phalalu diarios. Basado en Swiss Ephemeris, verificado contra almanaques de referencia. Instalación: uvx mcp-server-panchangam
Documentación
Fuentes de Calendario Panchangam Telugu
Fuentes de Panchangam Telugu suscribibles para 22 ciudades — entregadas como archivos .ics que puedes añadir a Google Calendar, Apple Calendar u Outlook.
Cada día aparece como un evento de todo el día (sin bloquear el calendario) con todos los detalles del Panchangam en la descripción. Los días festivos — Ugadi, Vinayaka Chavithi, Deepavali, Maha Shivaratri, el grupo de Sankranti y más de 30 más — están marcados con 🪔 en el título; otros días especiales (Ekadashi, Amavasya, Pournami, Pradosham, Sankranti, Eclipses) con ⚡.
Suscribirse
Visita la página de inicio para elegir tu ciudad y sistema de cálculo y copiar tu URL de webcal://:
El sitio también es un conjunto de herramientas diario: Panchangam de Hoy (cualquier fecha, cualquier ciudad), Tarabalam · Muhurtam
(buenos días y franjas horarias clasificadas para hasta cuatro personas según su estrella de nacimiento, con Chandrabalam), y el
gráfico de Gochara con Rasi Phalalu (gráfico del sur de India, veredictos de tránsito y una lectura diaria calculada).
Los invitados también pueden crear perfiles locales en el navegador a partir de datos astrológicos conocidos. El desarrollo local y una
compilación pública explícitamente activada pueden calcular Nakshatra, Padam, Janma Rashi, Lagna y un gráfico D1 revisable
a partir de fecha, hora exacta y lugar de nacimiento. Las compilaciones públicas fallan de forma segura hasta que el servicio de cálculo
con licencia y el proveedor de lugares sean aprobados; los perfiles calculados guardados permanecen visibles. El nombre nunca sale
del navegador. Consulta el contrato de cálculo y privacidad.
Las búsquedas de Drik Muhurtam también contienen un gráfico de tiempos candidatos respaldado por fuentes
después de la pantalla, protegido por una bandera independiente de fallo seguro. Las compilaciones públicas no realizan ninguna
solicitud de gráfico a menos que VITE_ELECTION_CHART_API_ENABLED sea exactamente true; consulta
el método de selección y el límite de publicación.
Todo se puede compartir a WhatsApp.
Cómo es la suscripción
Qué contiene el evento de cada día
- Metadatos — Samvatsara, Maasam, Paksham, Vaaram, signos solar y lunar
- Pancha Anga — Tithi, Nakshatra, Yoga, Karana con horas de inicio/fin
- Marcadores del cielo — Amanecer, Atardecer, Salida de la Luna, Puesta de la Luna
- Ventanas auspiciosas — Brahma Muhurta, Abhijit Muhurta, Amrita Kalam
- Ventanas inauspiciosas — Rahu Kalam, Gulika Kalam, Yamagandam, Varjyam, Durmuhurtham
- Choghadiya — 8 bloques diarios con nombres
- Eclipses — Eclipses solares y lunares con tipo (Total/Parcial/Anular/Penumbral), visibilidad desde tu ciudad, ventana del eclipse y período Sutak
- Yogas especiales — Sarvartha Siddhi, Amrita Siddhi, Visha y Dagdha yogas basados en la combinación de día de la semana/tithi/nakshatra
Ciudades
Corazón Telugu — Hyderabad, Vijayawada, Visakhapatnam, Tirupati, Warangal, Guntur, Nizamabad, Rajahmundry, Kurnool, Nellore
Principales metrópolis indias — Bengaluru, Chennai, Mumbai, Delhi
Diáspora internacional — Dallas, San Jose, San Francisco, Edison (NJ), Nueva York, Londres, Sídney, Dubái
Sistemas de cálculo
| Sistema | Base | Mejor para |
|---|---|---|
| Drik Ganita | Swiss Ephemeris (pyswisseph) — admite ayanamsas Lahiri, Raman, Krishnamurti, True Chitrapaksha | Aplicaciones modernas, eventos celestes precisos |
| Surya Siddhanta | Algoritmos de movimiento medio del texto clásico SS | Tradiciones arraigadas en el cálculo siddhántico clásico |
| Vakya | Surya Siddhanta + tablas de corrección publicadas | Panchangams impresos tradicionales en telugu/tamil |
Servidor MCP
mcp-server-panchangam está disponible en PyPI. Es un servidor MCP stdio estándar (uvx mcp-server-panchangam), por lo que funciona con cualquier cliente o agente compatible con MCP — Claude Desktop, Claude Code, Cursor, Windsurf y agentes personalizados construidos sobre el SDK de MCP. A continuación se muestran ejemplos para un par de clientes comunes; para otros, apunta la configuración MCP de tu cliente al mismo comando uvx mcp-server-panchangam.
Claude Desktop — añade a ~/Library/Application Support/Claude/claude_desktop_config.json:
{
"mcpServers": {
"panchangam": {
"command": "uvx",
"args": ["mcp-server-panchangam"]
}
}
}
Claude Code — ejecuta una vez:
claude mcp add panchangam -- uvx mcp-server-panchangam
Herramientas disponibles
Panchangam diario
| Herramienta | Descripción |
|---|---|
get_panchangam | Panchangam completo para cualquier fecha y ciudad |
get_muhurta | Ventanas auspiciosas/inauspiciosas de un día (llamada más ligera; usa find_muhurta para buscar entre días) |
get_panchanga_shuddhi | Veredicto de pureza de cinco miembros (Sarva Shuddha → Sarva Ashuddha) con calidad y motivo por miembro |
Planificación entre días
| Herramienta | Descripción |
|---|---|
get_panchangam_range | Resumen compacto del Panchangam para cada día en un rango (máx. 31 días) |
get_special_days | Festivales con nombre, Ekadashi, Amavasya, Pournami, Pradosham, Sankranti y Eclipses de un mes |
find_muhurta | Franjas horarias auspiciosas clasificadas — conscientes de la actividad, cada franja con sus motivos |
find_tarabalam_days | Tarabalam y Chandrabalam — días favorables para 1–4 personas según su estrella de nacimiento (y rashi) |
Eventos celestes
| Herramienta | Descripción |
|---|---|
get_combustion_calendar | Períodos de Asta/Udaya (entrada/salida de combustión) para Mercurio, Venus, Marte, Júpiter, Saturno |
get_graha_yuddha | Períodos de Graha Yuddha (guerra planetaria) — ganador, perdedor, horario en UTC |
get_rashi_ingresses | Todos los eventos de cambio de signo rashi para los planetas clásicos en un rango de fechas |
get_eclipse_calendar | Eclipses solares y lunares con visibilidad por ciudad y horario de Sutak |
Gochara y tránsitos personales
| Herramienta | Descripción |
|---|---|
get_graha_positions | Los nueve grahas al amanecer — rasi, nakshatra, retrógrado, fechas del siguiente rasi |
get_gochara | Veredictos de Gochara desde un janma rashi — casas, vedha, Sade Sati / Ashtama Shani |
get_rasi_phalalu | Lectura diaria determinista generada a partir de hechos calculados |
Horarios intradía
| Herramienta | Descripción |
|---|---|
get_daily_horas | 24 horas planetarias (horas) del día, comenzando al amanecer con el señor del día de la semana |
get_lagna_transitions | Límites de signo del Ascendente (Lagna) que rastrean el horizonte oriental a lo largo del día |
Utilidad
| Herramienta | Descripción |
|---|---|
list_supported_cities | 22 ciudades preconfiguradas con latitud/longitud/zona horaria |
Todas las herramientas aceptan cualquier nombre de ciudad en texto libre. Las ciudades preconfiguradas se resuelven al instante; cualquier otra ciudad se geocodifica mediante OpenStreetMap. También puedes pasar latitude, longitude y timezone directamente.
Las herramientas del sistema Drik que aceptan un city o fecha también aceptan ayanamsa=lahiri|raman|krishnamurti|true_chitrapaksha (predeterminado: lahiri). Documentación completa de la API y detalles de parámetros: mcp-server-panchangam en PyPI.
Cómo funciona
Las fuentes se generan el día 1 de cada mes mediante GitHub Actions, cubriendo 18 meses hacia adelante. Se sirven como archivos estáticos .ics desde GitHub Pages — costo de alojamiento cero.
GitHub Actions (monthly cron)
→ python -m telugu_panchangam.generate (22 cities × 3 systems = 66 feeds)
→ feeds/*.ics
→ GitHub Pages (webcal:// subscriptions)
Mantenimiento y hoja de ruta
La cola de mantenimiento activa es el Proyecto de GitHub de Utilidades de Calendario Telugu. Usa los campos vinculados de estado y prioridad para ver qué está planificado, en curso o listo para revisión. Reporta defectos y propuestas de funciones en Issues del repositorio.
Los archivos CSV y los planes de fases bajo docs/tracking/ son registros
históricos conservados; no son una segunda lista de pendientes.
Documentación
El repositorio es la fuente canónica de documentación. Comienza con el
estándar de documentación para saber dónde pertenecen las referencias actuales,
operaciones, decisiones y material histórico, y luego usa el
índice de referencia de cálculo para el mapa
detallado del sistema. Una proyección VitePress buscable se construye a partir de estos archivos en
/docs/; es una salida de presentación desechable y no reemplaza al
repositorio como fuente de verdad.
Licencia y código fuente correspondiente
Copyright (C) 2026 Vinay Chaganti.
Este proyecto es software libre bajo la GNU Affero General Public License v3.0 o posterior. Los usuarios del sitio web y del paquete MCP pueden obtener el código fuente correspondiente completo, incluidas las instrucciones de compilación y las pruebas, desde este repositorio. Los avisos de dependencias directas para PySwissEph y Swiss Ephemeris se conservan en THIRD_PARTY_NOTICES.md.
Este proyecto selecciona la vía AGPL en el modelo de doble licencia de Swiss Ephemeris. Las copias anteriores permanecen disponibles bajo los términos de licencia transmitidos con esas copias; esta versión no retira una concesión anterior.
Desarrollo
Requiere Python 3.10+, uv y Node.js 24.
uv sync --locked --extra test --extra browser-test
uv run playwright install chromium
npm ci --ignore-scripts
uv run python tools/verify_project.py
uv run python -m telugu_panchangam.generate # writes to feeds/