Skip to content
RoxyAPI
Get API Key
Workflow / Open Source15 minMIT LicenseWhite-label ready

n8n AI Astrology Chatbot

A multi-agent astrology reader in n8n, on web chat and Telegram, with a forecast every morning.

n8n AI astrology chatbot template: a reader agent hands each question to Western, Vedic, numerology, tarot, Human Design and BaZi specialists. Every chart, number and card comes from a live calculation, never from the model. It saves each birth profile to an n8n Data Table, writes compatibility reports across four systems, answers on a hosted chat page and on Telegram, and sends subscribers a morning forecast with sky alerts. One setting switches between Google Gemini, OpenAI and Anthropic.

A free open source template, not a subscription plan: clone it, add your API key and ship under your own brand. Comparing tiers? See pricing.

AstrologyVedicForecastHuman DesignNumerologyTarot
n8n AI astrology chatbot workflow: chat and Telegram triggers, a reader agent with a model selector, specialist agents with RoxyAPI tools and a daily forecast branch

What it ships with

  • Import one JSON file, run the one-time setup, add a RoxyAPI key and one AI provider key
  • A reader agent delegates to specialist agents, each with its own RoxyAPI tools
  • Birth profiles saved in an n8n Data Table, so every later chat starts from the chart
  • Compatibility reports across Western synastry, Vedic gun milan, numerology and BaZi
  • A morning forecast on Telegram with the personal day number, the Moon and sky alerts
  • Hosted chat page and Telegram on one path, on Google Gemini, OpenAI or Anthropic

Screenshots

n8n AI Astrology Chatbot screenshot
n8n AI Astrology Chatbot screenshot

README

n8n AI Astrology Chatbot: a free MIT n8n workflow template for multi-agent AI astrology readings on web chat and Telegram, built on RoxyAPI

n8n AI Astrology Chatbot Template: Multi-Agent Readings for Birth Charts, Vedic Kundli, Tarot, Numerology and Daily Forecasts

An import-ready n8n workflow for AI astrology readings on web chat and Telegram. A reader agent hands each question to specialist agents for Western astrology, Vedic astrology, numerology, tarot and I Ching, Human Design and Chinese BaZi, remembers every birth profile, writes cross-system compatibility reports and sends each subscriber a personal forecast every morning. Every chart, number and card comes from a live RoxyAPI calculation verified against NASA JPL Horizons, not from the model, and it runs on Google Gemini, OpenAI or Anthropic.

Get API Key Try the API live Remote MCP n8n node Video walkthrough n8n guide Methodology More Templates

The AI astrology chatbot workflow in the n8n editor: chat and Telegram triggers, a reader agent, a model selector over three AI providers, specialist agents with their RoxyAPI tools, and the daily forecast branch

Is there a video walkthrough?

Yes. n8n AI astrology chatbot: multi-agent readings with one RoxyAPI key imports this workflow from its GitHub URL, creates the profile table, adds the RoxyAPI and Gemini keys, connects one model to the model selector, then asks for a birth chart and a four-system compatibility report.

The n8n AI astrology chatbot video walkthrough

What does this n8n workflow do?

It runs a full AI astrology reading service inside n8n:

  • Answers on web chat and Telegram through one shared path, replying on the channel each message came from.
  • Remembers every person. The first time someone shares a birth date, time and city, the reader resolves the city and saves the birth profile to an n8n Data Table. Every later conversation starts from that profile.
  • Delegates to specialists. The reader agent routes each question to the specialist that owns it, so every agent keeps a short, focused prompt and only the tools it needs.
  • Writes compatibility reports across four systems. One request runs Western synastry, Vedic Ashtakoot gun milan, numerology compatibility and BaZi compatibility, then combines them into one verdict with the result from each system, where they agree and where they differ.
  • Sends a personal forecast every morning to Telegram subscribers: the personal day number, the Moon phase, the strongest transits of the week from their own chart, and a sky alert on days with a major transit or a new or full Moon.
mermaid
flowchart LR
  A[Web chat] --> S[Workflow settings]
  T[Telegram] --> S
  M[Every morning] --> S
  S --> N[Normalize message] --> P[Load saved birth profile] --> R[AI astrology reader]
  R --> W[Western astrologer]
  R --> V[Vedic astrologer]
  R --> U[Numerologist]
  R --> C[Tarot and I Ching reader]
  R --> H[Human Design analyst]
  R --> Z[Chinese astrologer]
  R --> O[Reply on the same channel]
  S --> D[Daily forecast subscribers] --> F[Digest, day number, Moon, sky alert] --> X[Telegram message]

Which specialists and RoxyAPI tools does it use?

SpecialistRoxyAPI tools (Resource → Operation)
AI astrology readerLocation and Timezone → Search Cities, Forecast → Generate Digest, plus the Save birth profile Data Table tool
Western astrologerGenerate Natal Chart, Calculate Transit Aspects, Generate Progressions, Calculate Synastry, Get Daily Horoscope
Vedic astrologerGenerate Birth Chart (kundli), Get Current Dasha, Get Basic Panchang, Detect Yogas, Check Manglik Dosha, Calculate Gun Milan
NumerologistGenerate Numerology Chart, Calculate Personal Day, Calculate Numerology Compatibility
Tarot and I Ching readerCast Three Card, Cast Love Spread, Cast Celtic Cross, Cast Yes No, I-Ching → Cast Reading
Human Design analystGenerate Bodygraph, Calculate Connection
Chinese astrologerGenerate Bazi Chart, Calculate Annual Forecast, Calculate Bazi Compatibility

The city search returns coordinates and an IANA timezone, so a summer birth and a winter birth both get the correct daylight saving offset. Nobody is ever asked for latitude or longitude.

How do I import it into n8n?

  1. Install the RoxyAPI node: in the nodes panel, search for RoxyAPI, select it and press Install node. It is a verified community node, so this works on n8n Cloud and self-hosted n8n.
  2. Import the workflow: download ai-astrology-chatbot.json, then in a new workflow open the ⋯ menu and choose Import from File.
  3. Create the profile table: run Run once to create the profile table. It creates the astrology_profiles Data Table and reuses it when it already exists.
  4. Add your RoxyAPI key: open any RoxyAPI node and create a credential with your key from roxyapi.com/pricing. The other RoxyAPI nodes reuse it.
  5. Pick your AI provider: add a key to the Google Gemini, OpenAI or Anthropic model node and set aiProvider in Workflow settings to gemini, openai or anthropic.
  6. Telegram (optional): add a bot token from BotFather to the three Telegram nodes, or delete them for web chat only.
  7. Activate the workflow and press Open chat.

Do I need keys for all three AI providers?

No. n8n activates a workflow only when every connected model has a credential, so keep the providers you have keys for. With one key, delete the other two model nodes and connect your model to all three Model inputs of Model selector; it takes about thirty seconds. With two or three keys, switch between them any time by changing aiProvider.

How does the reader decide what to do?

The system message on AI astrology reader sets the rules: every fact about a chart, number, card or forecast comes from a tool or a specialist, missing birth details are asked for one at a time, an unknown birth time falls back to 12:00 with a note that the rising sign, houses and hour pillar may be off, every city is resolved before a chart, and replies stay warm and specific without presenting health, legal or financial outcomes as certain. Specialists do not see the conversation, so the reader passes each one the question and every birth detail it needs in one message.

How do the daily forecast and sky alerts work?

On Telegram the reader offers a daily forecast once a profile is saved and stores the answer in the profile. Every morning at 7 the schedule reads every subscriber, calls the personal forecast digest, the personal day number and the current Moon phase, and flags a sky alert when today holds a new or full Moon or a transit of high significance to the chart of that person. A model turns the data into a short message, which goes out on Telegram. Saying stop in the chat turns it off.

Can I put the chat on my own website?

Yes. The chat trigger is set to Hosted Chat, so once the workflow is active it serves a public chat page with the title, subtitle and greeting already written. Switch its mode to Embedded Chat to place it inside your own site instead.

The hosted chat page answering a Western and Vedic birth chart question

How do I customize the workflow?

  • Widen a specialist: add another RoxyAPI node on its Tool input and pick any operation, from Vedic divisional charts and KP astrology to solar returns and astrocartography. Click the star on a field to let the model fill it; on a dropdown field, switch to Expression and use {{ $fromAI('name', 'what the model should pass') }}.
  • Add a specialist: duplicate one, rename it, write its description and system message, and give it tools from another domain such as crystals, dreams, angel numbers, Ayurveda or feng shui. Then name it in the reader system message.
  • Answer in another language: every RoxyAPI tool has a Language option under Options covering 10+ languages, and the reader already replies in the language the person writes in.
  • Change the morning hour: edit Every morning at 7. It runs in the timezone of your n8n instance.
  • Remember longer: raise Context Window Length on Conversation memory, or swap it for a database-backed memory for production traffic.

What does it need?

RequirementVersion
n8n2.x with Data Tables, n8n Cloud or self-hosted
RoxyAPI n8n node@roxyapi/n8n-nodes-roxyapi 1.0.13 or newer
RoxyAPI keyAny plan; one key covers every domain
AI provider keyGoogle Gemini, OpenAI or Anthropic
Telegram botOptional, for Telegram chat and the daily forecast

Built with RoxyAPI

RoxyAPI is the Spiritual OS layer for agentic AI: Western and Vedic astrology, Human Design, numerology, tarot, the I Ching and many more insight domains on one API key, verified against NASA JPL Horizons, with typed SDKs, Remote MCP and flat pricing. Learn more in the n8n guide, the API reference, the methodology and the other open source templates.

License

MIT. Clone it, rebrand it and ship it under your own brand.

Ready to ship?

Clone the repo, add your API key, deploy to your stack.