8 real-world workflows

User Intent

A user provides their birth date, time, and place. The agent returns a readable summary of their natal chart.

Agent Workflow

1. 1.Convert birth datetime and location to Julian Day and coordinates.
2. 2.Call compute_natal_chart with the preferred ayanamsha and house system.
3. 3.Read chart_highlights to identify the most significant features.
4. 4.Use nl_description fields to compose a natural language summary.
5. 5.Optionally call emit_graph with EmbeddingText to store facts in a vector database.

Vedākṣha Tools Used

User Intent

A user wants to be notified when significant planetary transits are approaching — sign ingresses, retrogrades, or conjunctions with natal planets.

Agent Workflow

1. 1.Call search_transits with a 30-day window and the user's preferred event types.
2. 2.Stream results as they arrive — no need to wait for the full search to complete.
3. 3.Compare transit positions against the user's stored natal chart (from a prior compute_natal_chart call).
4. 4.For each significant transit, use the nl_description field to compose an alert message.
5. 5.Schedule re-runs daily to detect new events entering the window.

Vedākṣha Tools Used

User Intent

Two users want to understand the astrological compatibility between their charts.

Agent Workflow

1. 1.Compute natal charts for both individuals using compute_natal_chart.
2. 2.Emit both charts to a graph database using emit_graph with Cypher format.
3. 3.Query the graph for inter-chart aspects — Planet A in Chart 1 aspecting Planet B in Chart 2.
4. 4.Identify key synastry patterns: conjunctions to angles, mutual receptions, shared sign placements.
5. 5.Summarize findings using nl_description fields and chart_highlights from both charts.

Vedākṣha Tools Used

User Intent

A user wants to find an auspicious time for an important event — a wedding, business launch, or journey.

Agent Workflow

1. 1.Determine the user's location and the date range they are considering.
2. 2.Call search_muhurta with criteria appropriate to the event type.
3. 3.Rank the returned windows by score and present the top options.
4. 4.For each recommended window, explain the active nakshatra, tithi, and yoga.
5. 5.Optionally overlay the muhurta against the user's natal chart for personalized scoring.

Vedākṣha Tools Used

User Intent

A user wants to understand their current and upcoming planetary periods (dashas) and what they signify.

Agent Workflow

1. 1.Call compute_natal_chart to get the Moon's sidereal longitude.
2. 2.Call compute_dasha with the Moon longitude and the preferred dasha system (Vimshottari, Yogini, or Chara).
3. 3.Navigate the DashaTree to find the current active period at each level.
4. 4.Use nl_description fields to explain the significance of each active period.
5. 5.Project upcoming period transitions and highlight when the next Mahadasha change occurs.

Vedākṣha Tools Used

User Intent

An application wants to build a persistent, queryable knowledge graph of astrological charts for research or multi-user analysis.

Agent Workflow

1. 1.For each chart request, call compute_natal_chart.
2. 2.Call emit_graph with Cypher or SurrealQL to generate database statements.
3. 3.Execute the statements against Neo4j or SurrealDB.
4. 4.Deterministic IDs ensure that repeated computations for the same input merge cleanly without duplicates.
5. 5.Query the graph across charts: "Which charts have Jupiter in the 10th house aspecting the Ascendant lord?"

Vedākṣha Tools Used

User Intent

A chat application answers astrological questions by retrieving relevant facts from a vector store of chart data.

Agent Workflow

1. 1.When a chart is computed, call emit_graph with EmbeddingText format.
2. 2.Split the output into chunks and embed each chunk using a text embedding model.
3. 3.Store the embeddings in a vector database with the chart ID as metadata.
4. 4.When a user asks a question, embed the question and retrieve the most relevant chart facts.
5. 5.Pass the retrieved facts as context to the language model for grounded, accurate answers.

Vedākṣha Tools Used

User Intent

A researcher wants to analyze patterns across hundreds of charts — for example, finding correlations between specific planetary configurations and life events.

Agent Workflow

1. 1.Batch-compute charts using compute_natal_chart for each subject in the dataset.
2. 2.Emit all charts to a graph database using emit_graph.
3. 3.Write graph queries to find statistical patterns across the corpus.
4. 4.Use compute_vargas to add divisional chart data for deeper analysis.
5. 5.Export findings as structured data for further statistical analysis.

Vedākṣha Tools Used