Kairos Codex - AI Bible Assistant (Web App)

Kairos Codex is an intelligent AI chatbot assistant designed to simplify and enrich Bible study. It allows users to ask natural language questions, compare translations and verses, engage in neutral discussions about biblical content, and receive personalized passage suggestions.

This web application is built with Next.js and utilizes a Large Language Model (LLM) that is empowered with tools to access Bible data via a separate Kairos Codex MCP Server.

Vision

To provide an intuitive, interactive, and neutral platform for individuals to explore and understand the Bible, leveraging modern AI capabilities and standardized data access through the Model Context Protocol (MCP), in many different languages.

Core Features (MVP)

• Chat Interface: A clean and responsive web UI (built with shadcn/ui and Tailwind CSS) for interacting with the AI assistant.
• Natural Language Q&A: Ask questions about biblical topics and receive verse-backed, neutral answers.
• Direct Verse Lookup: Quickly retrieve and display specific Bible verses.
• LLM Integration: Utilizes a powerful LLM (e.g., via Vercel AI SDK) to understand queries and generate responses.
• MCP Tool Usage: The LLM is equipped with "tools" to call the Kairos Codex MCP Server for accessing Bible data, ensuring responses are grounded in scripture.

Tech Stack

• Framework: Next.js (React)
• Styling: Tailwind CSS
• UI Components: shadcn/ui
• AI/LLM Interaction: Vercel AI SDK (or similar)
• Deployment: Vercel
• Version Control: Git / GitHub

Getting Started

(To be filled in later - setup, environment variables, running locally)

Prerequisites

• Node.js (version X.X.X)
• npm/yarn/pnpm
• Access to the Kairos Codex MCP Server (running locally or deployed)
• API Key for the chosen LLM provider

Installation

git clone https://github.com/your-username/kairos-codex-webapp.git
cd kairos-codex-webapp
npm install
# or yarn install / pnpm install

Environment Variables

Create a .env.local file in the root directory and add the following:

# Example
LLM_PROVIDER_API_KEY=your_llm_api_key
MCP_SERVER_URL=http://localhost:8000/mcp # Or your deployed MCP server URL
# Add other necessary environment variables

Running Development Server

npm run dev
# or yarn dev / pnpm dev

Open http://localhost:3000 with your browser to see the result.

Contributing

(To be filled in later - contribution guidelines)

License

(To be determined - e.g., MIT, GPL)