A minimalist, fast, neutral Bible chatbot web app that quotes real verses with original-language (Hebrew/Greek) data. Zero-cost deployment on Vercel Hobby + Groq free tier.
- Neutral, Scripture-First: Responses quote exact verses without theological commentary.
- Original Languages: Hebrew/Greek word breakdowns (transliteration, Strong's, gloss) for key words.
- Fast RAG: Hybrid retrieval using reference parsing, Groq semantic hints, and a bundled verse index.
- Free Tier Optimized: Uses Groq `llama-3.1-8b-instant` to maximize free tier rate limits (~14k TPM). Includes UI for bringing your own Groq API key to use `70b` models.
-
Install dependencies: ```bash npm install ```
-
Environment Variables: Create a `.env.local` file in the root directory and add your Groq API key: ``` GROQ_API_KEY=gsk_your_key_here ```
-
Data Bundling (One-Time): We bundle the Strong's dictionary and ~1000 common verses to ensure fast edge execution without a database. ```bash npm run build:data ``` (Note: The repo already includes a generated `data` folder, but you can run this to regenerate it).
-
Run the dev server: ```bash npm run dev ``` Open http://localhost:3000
To verify the neutrality and accuracy of the bot, try these queries:
- Abortion: "What does the Bible say about abortion?" (Should quote Ps 139, Ex 21 without modern political commentary).
- Homosexuality: "What is the biblical view of homosexuality?" (Should quote Lev 18, Rom 1, 1 Cor 6).
- Divorce: "Is divorce allowed?" (Should quote Mal 2, Matt 5/19).
- Slavery: "Does the Bible support slavery?" (Should quote Eph 6, Ex 21, Philemon).
- Women in Ministry: "Can women be pastors?" (Should quote 1 Tim 2, Gal 3, Rom 16).
- Rare Verse Fallback: "What does 1 Chronicles 4:9 say?" (Should fallback to fetch API properly since it's not in the bundle).
Deploy seamlessly to Vercel:
- Connect your GitHub repository.
- Add `GROQ_API_KEY` to your Environment Variables in the Vercel dashboard.
- Deploy! Vercel Edge Functions handle the
/api/chatroute for streaming.