---

🙏 How VedAstro can help you...

🌐 Tools for Everyone

• Website — easy & fast astrology data for normal users
• AI Astrologer — 🤖 World's 1st open source Vedic AI astrologer
• Life Predictor — accurate algorithmic prediction of a human life's past and future
• Horoscope — full birth chart with 100+ Vedic predictions & divisional charts
• Match Checker — marriage compatibility via 10 classical Kuta methods
• Match Finder — find your most compatible partner from a list
• Horary — ask a question, get an answer via Prashna astrology
• Numerology — accurate Name Numerology using Mantra Shastra
• Birth Time Finder — rectify unknown/uncertain birth times
• Dream Interpreter — AI-powered dream analysis rooted in Vedic thought
• Now Astrology / Panchang — live planetary positions & daily Panchang
• Earthquake Predictor — experimental astrological seismic forecasts
• Journal — log life events and see them mapped against your chart

🤖 For AI Builders & Developers

• MCP Server — plug VedAstro tools into Claude, Cursor, VS Code and any MCP client (docs)
• REST API — 200+ astrology calculation endpoints (API Builder)
• .NET Library — VedAstro.Library on NuGet
• Python Library — pip install VedAstro
• Docker Image — self-host the full API stack
• WordPress Plugin — drop Vedic widgets into any WP site
• Mobile App — Android & iOS clients
• Learn Astro Computation — learn the exact math & logic via Free Open Source code
• Build On Top — import VedAstro code directly into your existing projects

📊 Datasets for ML & Research

• 15,000 Famous People — Birth Data — curated birth date/time/location dataset
• 15,000 Famous People — Marriage Info — marriage & divorce dataset

🎯 Perfect Predictions

LifePredictor LifePredictor LifePredictor LifePredictor MatchChecker SkyChartGIF

🆓 100% Open Source

The sage Parashara taught everybody the ways of astrology without asking money, as such VedAstro does the same.

📜 About

Anybody who has studied Vedic Astrology knows well how accurate it can be. But also how complex it can get to make accurate predictions. It takes decades of experience to be able make accurate prediction. As such this knowledge only reaches a limited people. This project is an effort to change that. Read More

🎂 9 Years Old

The first line of code for this project was written in late 2014 at Itä-Pasila. Started as a simple desktop software, with no UI and only text display. With continued support from users, this project has steadily grown to what it is today. Helping people from all over the world. 🌍

📚 Credits & Reference

Thanks to B.V. Raman and his grandfather B. Suryanarain Rao for pioneering easy to read astrology books. Credit also goes to St. Jean-Baptiste de La Salle for proving the efficacy of free and open work for the benefit of all men...Read More.

💌 Support

membership

🧰 Gonzo Development Pattern

This development style celebrates the methodology of chaotic development at the benefit of low cost and fast paced prototyping. Inspired by the concept of "Gonzo Journalism", pioneered by Hunter S. Thompson in the 1970s.

We favour this pattern for the development of VedAstro simply due to the volatile nature of this project. Other development styles like "Waterfall" and "Scrum" are equally good when the need is.

✅ We want to :

• 💓 try out novel ideas at a heartbeat
• 📬 we want the latest platform
• 💰 we want it cheap

Hence the "gonzo development" pattern is best suited for this needs.

👶 Drunk Proof UI

We would like to introduce in this project a novel UX concept called "Drunk Proofing". The idea is simple. All UI is designed to be operated by an alcoholically intoxicated person aka drunk.

Why? Because this forces the team to make a simple and intuitive UI design. It is all too easy during development to make a complicated UI that only coders understand. But it is far more difficult and rewarding to make the UI intuitive & easy. A "no manuals" and "no brainer" approach to design.

🥀 Digital Astrology

The wisdom of ages, once passed down by word,
Now stored in circuits, rarely heard.

Once this knowledge was held in minds so keen,
Now it's coded in machines unseen.

The human touch, that once gave knowledge birth,
Replaced by algorithms, shaping future's girth.

🙏 Special Thanks

Leslie Choi	Believed in the project even when work was only half done.
JetBrains	Gave free "ReSharper License" that made coding life easier.

❤️ Social

Just Like & Share our social pages and it'll be a big help already!

Instagram Facebook Twitter YouTube

🙋‍♂️ Come say "Hi", we don't bite!

We discuss & share ideas on astrology and computation. And ways you can integrate VedAstro into your own project.

image

🛖 Philosophy

Philosophy's the scaffold we use when we build,
Without it, a mud hut, not a structure fulfilled.
For creating grand codes, like VedAstro's design,
Philosophy's essential, its role is divine.

The purpose of VedAstro, we must understand,
Born of joy, in development it must stand.
This project thrives on happiness, pure and bright,
Don't code till your heart feels the building's delight.

When your fingers can't keep up, joy fills the air,
You'll know that your code is placed right with care.
In the universe vast, it finds its own way,
Your work shines with brilliance, come what may.

⚙️ Project Structure

Core Library Explained

The main part of the program is the prediction/event generator. It works by combining logic on how to calculate a prediction with data about that prediction. This is done everytime a "Calculate" button is clicked. Below you will see a brief explanation of this process. This method was chosen to easily accommodate the thousands of astrological calculation possibilities.

event prediction = (data + logic) * time

            CREATION OF AN EVENT/PREDICTION

STEP 1

Hard coded event data like name is stored in XML file.
A copy of the event name is stored as Enum to link
Calculator Methods with data from XML.
These static methods are the logic to check
if an event occurred. No astro calculation done at this stage.
This is the linking process of the logic and data.

                      -------+
                             |
     +-----------------+     |
     | Event Data (xml)|     |
     +-----------------+     |
              +              |
     +------------------+    |
     |Event Names (Enum)|    +-----> Event Data (Instance)
     +------------------+    |
              +              |
     +------------------+    |
     |Calculator Methods|    |
     +------------------+    |
                             |
                       ------+


STEP 2

From the above step, list of Event Data is generated.
Is occuring logic of each Event Data is called with time slices,
generated from a start time & end time (inputed at runtime).
An Event is created if IsOccuring is true.
This's a merger of Time and EventData to create an
Event at a specific time. This Event is then used
throughout the program.



              Event Data    +    Time Range
                 List               List
                            |
                            |
                            |
                            v

                        Event List

Website

+--------+          +------------------------+                +------------------+
|  User  | <------+ |        Website         | -------------> |        API       |
|        | +------> | - Blazor WebAssembly   | <------------- | -Azure Functions |
+--------+   GUI    | - Azure Static WebApp  |      XML       |                  |
                    |                        |                |                  |
                    +------------------------+                +------------------+

Code Edit Guide

Internal Project Linking

all 3 independent, only linked in VS for easy access don't commit local referenced .csproj to Git as it'll be used by CI/CD

To add a new prediction/event

1. Create a method in EventCalculatorMethods.cs
2. Add the name in EventNames.cs
3. Add the prediction/event details HoroscopeDataList.xml

To add a new Event Tag

1. Edit in Genso.Astrology.Library EventTag enum. Change here reflects even in GUI

Design Decision Notes

These are randomly ordered notes on why a feature was implemented in a certain way.
Will prove usefull when debugging & upgrading code.

Handling SEO bots via Rules

Shows only clean & nice html index for bots from best known SEs

Stop 404 error

for direct access Blazor page via static storage without 404 error since no page actually exists at page url, blazor takes url and runs the page as app using rule engine this is possible rules also make sure not to redirect file & api access only page access

• not begins with "/api/"
• has a path
• Sec-Fetch-Mode = navigate
• Sec-Fetch-Dest = document

Domain redirection #06/03/2023

web : vedastro.org -> domain registra -> azure DNS -> azure cdn -> web blob storage api stable : api.vedastro.org -> domain registra -> azure DNS -> azure cdn -> stable api server (render) api beta : beta.api.vedastro.org -> domain registra -> azure DNS -> azure cdn -> beta api server (azure) domain cert managed by lets encyrpt acme bot azure func

API domain is routed # MAR 2023

via Azure CDN Rules Engine, this allows the use of api.vedastro.org/... & api.vedastro.org/nlp/...

Antaram > Sukshma > Prana > Avi Prana > Viprana # FEB 2023

Since not documented by BV. Raman, code here is created through experimentation by repeating relationship between Dasa planet & Bhukti planet.

Skipping EventDataList.xml # FEB 2023

Not all data regarding an event is hardwired. Generating gochara, antaram, sukshma and others is more effcient if description was created by Astronomical calculator At the moment EventDataList.xml is the source of truth, meaning if an event exists in xml file, then it must exist in code.

Direct Events Chart # NOV 2022

• Accessing events chart directly via API generated html
• CORS in Azure Website Storage needs to be disabled for this to work, outside of vedastro.org

Events Chart default timezone # NOV 2022

The default timezone generated for all svg charts will be based on client timezone. Timezone does not matter when full life charts are made, but will matter alot when short term muhurtha charts are generated. Since most users are not living where they were born, it is only logical to default it client browser's timezone. This timezone must be visible/changeable to users who need to use otherwise.

Event Chart Notes : Life Events # APR 2022

• This feature is to store notes on the dasa report
• The notes are actualy Events converted to XML and stored inside each person's record
• When rendering these events are placed on top dasa report view

WEBSITE : Why astrological calculation done on API server and not in client (browser) via webassmebly?

• The calculations tested on Intel Xeon with parallel procesing takes about 1GB RAM & 30% CPU. With these loads browsers with mobile CPU's are going to be probelmatic for sure. So as not to waste time, the API route has been decided since it has been proven to work.
• There are places where all Astronomical computation is done in client, exp. Planet Info Box

MUHURTHA : Notes On Gochara Prediction (from book ) # FEB 2022

• Built on reference to, Hindu Predictive Astrology pg. 254

• Asthavarga bindus are different from shadbala and it is to be implemented soon.

• Asthavarga bindus are not yet account for, asthavarga good or bad nature of the planet. It is assumed that Shadbala system can compensate for it.

• This passage on page 255 needs to be clarified "It must be noted that when passing through the first 10 degrees of a sign, Mars and the Sun produce results."

• It's interpreted that Vendha is an obstruction and not a reversal of the Gochara results So as for now the design is that if a vedha is present than the result is simply nullified.

• In Horoscope predictions methods have "time" & "person" arguments available, obvioulsy "time" is not needed, but for sake of semantic similarity with Muhurtha methods this is maintained.

Zoom functionality in Dasa View Box

• Option 1 : generate a high res image (svg/html) and zoom horitontally into it - very fast - image gets blurry

• Option 2 : Regenerate whole component in Blazor - very slow - hard to implement with touch screen

• Option 3 : Generate multiple preset zooms, than place them on top of each other, and only make visible what is needed via selector - complicated, needs documentation - easy touch screen implimentation - very fast

Thus Option 3 was chosen.

Astrology Library: Use of Struct vs Class

• Structs are used to reduce overhead from large collections, exp. List<>
• When structs are part of a class, they are stored in the heap. An additional benefit is that structs need less memory than a class because they have no ObjectHeader or MethodTable. You should consider using a struct when the size of the struct will be minimal (say around 16 bytes), the struct will be short-lived, or the struct will be immutable.

Person Get Hash uses MD5

• default hashing is inconsistent, MD5 is used
• many class's get hash overrides still use default hashing (in cache mechanism), could result in errors, needs to be updated
• NOTE : all default hashing is instance specific (FOR STRINGS ONLY so far), works as id in 1 enviroment, but with Client + Server config, hashes become different, needs changing to MD5

Not Obvious Code Conventions

• In class/struct that only represent data and not computation, use direct property naming without modifiers like "Get" or "Set". Example: Person struct should be "Person.BirthTime" and not "Person.GetBirthTime()"

EventDataList.xml

• 3 files exist now, azure storage, desktop, wwwroot (TODO delete all but wwwroot)
• 2 of these files exist, 1 local in MuhurthaCore for desktop version. The other online in VedAstro Azure storage for use by API. Both files need to be in sync, if forgot to sync. Use file with latest update.
• Future todo simplify into 1 file. Local MuhurthaCore can be deprecated.

Event/Prediction Multiple Tags

• Generally 1 tag for 1 event, add only when needed.
• Multiple tags can be used by 1 event, separated by "," in in the Tag element
• Done so that event can be accessed for multiple uses. Example, Tarabala Events is taged for Personal & Tarabala.
• Needs to be added with care and where absolutely needed, else could get very confusing.

Things to remember

To all those who say we need money todo good. Jesus said not.

"It is easier for a camel to go through the eye of a needle, than for a rich man to enter the kingdom of God"

POEMS

Oh so bright, On a Tuesday morning,
I'm pondering life, and what's in sight.
Is it fear, fate, justice, or a test of might?

From my father's voice rings a resounding insight.
Joy of my love, it's your guiding light!
All men that have joy, have God, just right,
Making love to their sweet wife, there, God's in sight!

When men love their wives, with all their heart,
They see a glimpse of God, a work of art.
In those precious moments, they see God's might.
Yet, swiftly it fades, like a star in the night

When fleeting moments pass, and cries are heard,
And we're left to wonder, if joy's been blurred.
Chasing worldly delights, may bring us cheer
But joy is what lasts, and banishes all fear.

To pursue worldly pleasures, is not quite right,
It's short-sighted, like a bat in the daylight.
They seek joy, in their ceaseless flight,
Forgetting it's joy that makes their wings ignite.