Create an Astrology Bot
Add a customizable astrology bot to your website in minutes. Try the live demo, then clone the Next.js starter with Western and Vedic chat contacts, scoped MCP calls, and Gemini-powered replies.
Setup takes a FreeAstroAPI key and a Google AI Studio API key.
Next.js-ready
Drop the component and API routes into an app router project.
MCP-powered
Ground answers in scoped FreeAstroAPI Western and Vedic bot tools.
Server-side keys
Keep FreeAstroAPI and Gemini credentials out of the browser.
Gemini answer layer
Use a fast model to turn chart facts into natural chat replies.
Choose an astrologer
2 contacts available
Astrology contacts
Start a consultation
Built for adoption
A starter you can understand, clone, and customize fast.
Choose Vedic or Western
Collect birth context in chat
Answer with MCP + Gemini
FAQ
Questions before you clone it?
The starter keeps the integration simple: server-side keys, one reusable chat component, and a small set of MCP-backed astrology flows you can adapt.
How much does it cost to run?
The starter itself is free to clone. Your running cost is the hosting you choose, your FreeAstroAPI usage, and your Gemini API usage. You can start free with FreeAstroAPI and Gemini to test the bot before paying for higher usage. For most early demos, the cost stays low because each chat turn is designed to use a small number of API calls. Check the current FreeAstroAPI pricing and Google AI Studio pricing before estimating production volume.
Do users need their own API key?
No. The bot runs through your server route. You keep FREE_ASTRO_API_KEY and GEMINI_API_KEY in environment variables, so visitors never see those credentials.
Can I customize the bot design?
Yes. The repo includes a reusable chat component and CSS module, so you can change the colors, copy, quick prompts, contact names, and layout for your own website.
Does it support both Vedic and Western astrology?
Yes. The demo starts with two contact choices, Vedic Astrologer and Western Astrologer, and routes each mode through the matching scoped MCP tools.
Can I add it to an existing Next.js project?
Yes. Copy the component, API routes, and required environment variables into an app router project, then adjust the route paths if your app uses a different structure.
Is it production-ready?
It is a practical starter, not a locked SaaS product. Before launch, add your own abuse limits, analytics, privacy copy, error monitoring, and any product-specific astrology flows.
Build your astrology bot for your website today.
Clone the starter, add two server-side keys, and customize the chat UI for your astrology product.