Telugu Panchangam
Cálculos de almanaque hindu como ferramentas MCP: tithi, nakshatra, janelas de muhurta, mais de 30 festivais, descoberta de dias favoráveis com tarabalam, trânsitos gochara e rasi phalalu diários. Baseado no Swiss Ephemeris, verificado em relação a almanaques de referência. Instalação: uvx mcp-server-panchangam
Documentação
Feeds de Calendário Panchangam Telugu
Feeds Panchangam Telugu assináveis para 22 cidades — entregues como arquivos .ics que você pode adicionar ao Google Calendar, Apple Calendar ou Outlook.
Cada dia aparece como um evento de dia inteiro (sem bloqueio de agenda) com todos os detalhes do Panchangam na descrição. Dias de festivais — Ugadi, Vinayaka Chavithi, Deepavali, Maha Shivaratri, o grupo Sankranti e mais de 30 outros — são marcados com 🪔 no título; outros dias especiais (Ekadashi, Amavasya, Pournami, Pradosham, Sankranti, Eclipses) com ⚡.
Assinar
Visite a página inicial para escolher sua cidade e sistema de cálculo e copie sua URL webcal://:
O site também é um kit de ferramentas diário: Panchangam de Hoje (qualquer data, qualquer cidade), Tarabalam · Muhurtam
(bons dias e horários classificados para até quatro pessoas por estrela de nascimento, com Chandrabalam), e o
gráfico Gochara com Rasi Phalalu (gráfico do sul da Índia, veredictos de trânsito e uma leitura diária calculada).
Visitantes também podem criar perfis locais no navegador a partir de detalhes astrológicos conhecidos. Desenvolvimento local e uma
build pública explicitamente ativada podem calcular Nakshatra, Padam, Janma Rashi, Lagna e um
gráfico D1 revisável a partir de data, hora exata e local de nascimento. Builds públicas falham de forma segura até que o serviço de cálculo
licenciado e o provedor de local sejam aprovados; perfis calculados salvos permanecem visíveis. O nome nunca sai do
navegador. Veja o contrato de cálculo e privacidade.
Buscas Drik Muhurtam também contêm um gráfico de horários candidatos com fonte comprovada
após a triagem, protegido por uma flag independente de falha segura. Builds públicas não fazem nenhuma
solicitação de gráfico a menos que VITE_ELECTION_CHART_API_ENABLED seja exatamente true; veja
o método de triagem e limite de lançamento.
Tudo é compartilhável via WhatsApp.
Como é a assinatura
O que há no evento de cada dia
- Metadados — Samvatsara, Maasam, Paksham, Vaaram, signos solar e lunar
- Pancha Anga — Tithi, Nakshatra, Yoga, Karana com horários de início/fim
- Marcadores do céu — Nascer do sol, Pôr do sol, Nascer da lua, Pôr da lua
- Janelas auspiciosas — Brahma Muhurta, Abhijit Muhurta, Amrita Kalam
- Janelas inauspiciosas — Rahu Kalam, Gulika Kalam, Yamagandam, Varjyam, Durmuhurtham
- Choghadiya — 8 blocos diários com nomes
- Eclipses — Eclipses solar e lunar com tipo (Total/Parcial/Anular/Penumbral), visibilidade da sua cidade, janela do eclipse e período Sutak
- Yogas especiais — Sarvartha Siddhi, Amrita Siddhi, Visha e Dagdha yogas com base na combinação dia da semana/tithi/nakshatra
Cidades
Coração Telugu — Hyderabad, Vijayawada, Visakhapatnam, Tirupati, Warangal, Guntur, Nizamabad, Rajahmundry, Kurnool, Nellore
Principais metrópoles indianas — Bengaluru, Chennai, Mumbai, Delhi
Diáspora internacional — Dallas, San Jose, San Francisco, Edison (NJ), New York, London, Sydney, Dubai
Sistemas de cálculo
| Sistema | Base | Melhor para |
|---|---|---|
| Drik Ganita | Swiss Ephemeris (pyswisseph) — suporta ayanamsas Lahiri, Raman, Krishnamurti, True Chitrapaksha | Aplicativos modernos, eventos celestes precisos |
| Surya Siddhanta | Algoritmos de movimento médio do texto clássico SS | Tradições enraizadas no cálculo siddhântico clássico |
| Vakya | Surya Siddhanta + tabelas de correção publicadas | Panchangams impressos tradicionais em telugu/tâmil |
Servidor MCP
mcp-server-panchangam está disponível no PyPI. É um servidor MCP stdio padrão (uvx mcp-server-panchangam), então funciona com qualquer cliente ou agente compatível com MCP — Claude Desktop, Claude Code, Cursor, Windsurf e agentes personalizados construídos no SDK MCP. Abaixo estão exemplos para alguns clientes comuns; para outros, aponte a configuração MCP do seu cliente para o mesmo comando uvx mcp-server-panchangam.
Claude Desktop — adicione a ~/Library/Application Support/Claude/claude_desktop_config.json:
{
"mcpServers": {
"panchangam": {
"command": "uvx",
"args": ["mcp-server-panchangam"]
}
}
}
Claude Code — execute uma vez:
claude mcp add panchangam -- uvx mcp-server-panchangam
Ferramentas disponíveis
Panchangam diário
| Ferramenta | Descrição |
|---|---|
get_panchangam | Panchangam completo para qualquer data e cidade |
get_muhurta | Janelas auspiciosas/inauspiciosas de um dia (chamada mais leve; use find_muhurta para pesquisar entre dias) |
get_panchanga_shuddhi | Veredicto de pureza de cinco membros (Sarva Shuddha → Sarva Ashuddha) com qualidade e motivo por membro |
Planejamento entre dias
| Ferramenta | Descrição |
|---|---|
get_panchangam_range | Resumo compacto do Panchangam para cada dia em um intervalo (máx. 31 dias) |
get_special_days | Festivais nomeados, Ekadashi, Amavasya, Pournami, Pradosham, Sankranti e Eclipses para um mês |
find_muhurta | Horários auspiciosos classificados — cientes da atividade, cada horário com seus motivos |
find_tarabalam_days | Tarabalam e Chandrabalam — dias favoráveis para 1–4 pessoas por estrela de nascimento (e rashi) |
Eventos celestes
| Ferramenta | Descrição |
|---|---|
get_combustion_calendar | Períodos Asta/Udaya (entrada/saída de combustão) para Mercúrio, Vênus, Marte, Júpiter, Saturno |
get_graha_yuddha | Períodos Graha Yuddha (guerra planetária) — vencedor, perdedor, horário em UTC |
get_rashi_ingresses | Todos os eventos de mudança de signo rashi para os planetas clássicos em um intervalo de datas |
get_eclipse_calendar | Eclipses solar e lunar com visibilidade por cidade e horário Sutak |
Gochara e trânsitos pessoais
| Ferramenta | Descrição |
|---|---|
get_graha_positions | Todos os nove grahas ao nascer do sol — rasi, nakshatra, retrógrado, próximas datas de rasi |
get_gochara | Veredictos Gochara a partir de um janma rashi — casas, vedha, Sade Sati / Ashtama Shani |
get_rasi_phalalu | Leitura diária determinística renderizada a partir de fatos calculados |
Horários intraday
| Ferramenta | Descrição |
|---|---|
get_daily_horas | 24 horas planetárias (horas) do dia, começando ao nascer do sol com o senhor do dia da semana |
get_lagna_transitions | Limites de signo do Ascendente (Lagna) rastreando o horizonte leste ao longo do dia |
Utilitário
| Ferramenta | Descrição |
|---|---|
list_supported_cities | 22 cidades pré-configuradas com latitude/longitude/fuso horário |
Todas as ferramentas aceitam qualquer nome de cidade em texto livre. Cidades pré-configuradas resolvem instantaneamente; qualquer outra cidade é geocodificada via OpenStreetMap. Você também pode passar latitude, longitude e timezone diretamente.
Ferramentas do sistema Drik que aceitam um city ou data também aceitam ayanamsa=lahiri|raman|krishnamurti|true_chitrapaksha (padrão: lahiri). Documentação completa da API e detalhes de parâmetros: mcp-server-panchangam no PyPI.
Como funciona
Os feeds são gerados no dia 1º de cada mês via GitHub Actions, cobrindo 18 meses à frente. Eles são servidos como arquivos estáticos .ics do GitHub Pages — custo zero de hospedagem.
GitHub Actions (monthly cron)
→ python -m telugu_panchangam.generate (22 cities × 3 systems = 66 feeds)
→ feeds/*.ics
→ GitHub Pages (webcal:// subscriptions)
Manutenção e roteiro
A fila de manutenção ativa é o Projeto GitHub de Utilitários de Calendário Telugu. Use os campos vinculados de status e prioridade para ver o que está planejado, em andamento ou pronto para revisão. Registre defeitos e propostas de recursos em Issues do repositório.
Os arquivos CSV e planos de fase em docs/tracking/ são registros
históricos preservados; eles não são um segundo backlog.
Documentação
O repositório é a fonte canônica de documentação. Comece com o
padrão de documentação para saber onde pertencem as referências atuais,
operações, decisões e material histórico, depois use o
índice de referência de computação para o mapa
detalhado do sistema. Uma projeção VitePress pesquisável é construída a partir desses arquivos em
/docs/; é saída de apresentação descartável e não substitui o
repositório como fonte da verdade.
Licença e código-fonte correspondente
Copyright (C) 2026 Vinay Chaganti.
Este projeto é software livre sob a GNU Affero General Public License v3.0 ou posterior. Usuários do site e do pacote MCP podem obter o código-fonte correspondente completo, incluindo instruções de build e testes, deste repositório. Avisos de dependências diretas para PySwissEph e Swiss Ephemeris são preservados em THIRD_PARTY_NOTICES.md.
Este projeto seleciona o caminho AGPL no modelo de licença dupla do Swiss Ephemeris. Cópias anteriores permanecem disponíveis sob os termos de licença transmitidos com essas cópias; este lançamento não retira uma concessão anterior.
Desenvolvimento
Requer Python 3.10+, uv e 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/