VedAstro  by VedAstro

AI-powered Vedic astrology insights and developer tools

Created 5 years ago
550 stars

Top 57.6% on SourcePulse

GitHubView on GitHub
Project Summary

VedaAstro provides a comprehensive, open-source platform for Vedic Astrology, making complex astrological computations and predictions accessible to both general users and developers. It offers a suite of tools, including an AI Astrologer, life predictor, horoscope generator, and compatibility checker, alongside APIs and datasets for researchers and builders. The project aims to democratize Vedic astrological knowledge through free, computationally robust software.

How It Works

The core of VedAstro is its prediction/event generator, which operates on the principle event prediction = (data + logic) * time. This model combines hard-coded event data (from XML) with computational logic (from C# methods), linked via Enums. This structured data is then processed against time slices to generate specific astrological events. The project embraces a "Gonzo Development Pattern" for rapid prototyping and a "Drunk Proof UI" design philosophy, prioritizing simplicity and intuitiveness. Astronomical computations are primarily handled server-side via an API due to resource demands.

Quick Start & Requirements

Installation options include a Python library (pip install VedAstro), a Docker image for self-hosting, and a .NET library available on NuGet. The project does not explicitly list hardware prerequisites like GPUs or specific CUDA versions for its core functionality. Key resources include the main website (https://vedastro.org/), an API builder (https://vedastro.org/APIBuilder.html), and demo pages for tools like LifePredictor (https://vedastro.org/LifePredictor.html) and MatchChecker (https://vedastro.org/MatchChecker.html).

Highlighted Details

  • Features the "World's 1st open source Vedic AI astrologer."
  • Offers curated datasets for ML & Research, including 15,000 Famous People's birth data and marriage information.
  • Provides over 200 astrology calculation endpoints via a REST API.
  • Supports integrations with AI assistants (Claude, Cursor, VS Code via MCP Server), WordPress, and mobile platforms (Android/iOS).
  • Includes experimental features like an Earthquake Predictor.

Maintenance & Community

The project has been active for approximately 9 years, with initial development starting in late 2014. While specific community channels like Discord or Slack are not detailed, the project encourages interaction, stating, "Come say 'Hi', we don't bite! We discuss & share ideas on astrology and computation." JetBrains provided a free ReSharper license, aiding development.

Licensing & Compatibility

VedAstro is presented as "100% Open Source," emphasizing a philosophy of freely sharing astrological knowledge. However, a specific OSI-approved license (e.g., MIT, GPL, Apache) is not explicitly stated in the README, which could pose compatibility questions for commercial or closed-source integration. The project allows direct import of its code into existing projects.

Limitations & Caveats

The "Gonzo Development Pattern" suggests a development methodology prioritizing speed and experimentation, which may imply less structured code or potential for rapid changes. The Earthquake Predictor is explicitly labeled as experimental. Asthavarga bindus are not yet implemented, with an assumption that the Shadbala system compensates. Multiple, potentially unsynchronized copies of the EventDataList.xml file exist across different storage locations, requiring manual management. Hashing mechanisms may exhibit inconsistencies in client-server configurations.

Health Check
Last Commit

1 month ago

Responsiveness

Inactive

Pull Requests (30d)
0
Issues (30d)
0
Star History
14 stars in the last 30 days

Explore Similar Projects

Feedback? Help us improve.