biblemate

# BibleMate AI

**BibleMate AI** is a groundbreaking, autonomous AI agent designed to revolutionize your Bible study. It can create study plans, coordinate multiple Bible tools, and take multi-step actions to complete complex Bible-related tasks, such as conducting an in-depth study of a particular Bible passage.

**🌐 Website:** https://biblemate.ai
**📺 Public Demo:** https://biblemate.gospelchurch.uk
**🔌 MCP Server:** https://bible.gospelchurch.uk/mcp
**📡 API Server:** https://biblemate.gospelchurch.uk/api/data

## Table of Contents

- [Overview](#overview)
- [Getting Started](#getting-started)
- [Key Features](#key-features)
- [Components & Repositories](#components--repositories)
- [Related Projects](#related-projects)
- [Data Repositories](#data-repositories)

## Overview

BibleMate AI is a comprehensive Bible study suite that represents a major upgrade from the [UniqueBible App](https://github.com/eliranwong/UniqueBible). It offers multiple interfaces and deployment options to suit different use cases:

- **CLI/TUI** - Command-line interface for terminal users
- **Web GUI** - Modern web interface accessible from any browser
- **MCP Server** - Model Context Protocol integration for AI assistants
- **HTTP/API Server** - RESTful API for custom integrations

## Getting Started

### Installation

Choose the package(s) that match your needs:

```bash
# TUI/CLI Version, Agent Mode, Partner Mode, and MCP Server
pip install --upgrade biblemate

# Headless CLI Version, Agent Mode
pip install --upgrade biblemateagent

# Bible Data Setup
pip install --upgrade biblematedata

# Web GUI, HTTP Server, API Server
pip install --upgrade biblemateweb
```

### Usage

```bash
# Launch TUI/CLI / Agent Mode / Partner Mode
biblemate

# Launch Headless CLI / Agent Mode
biblemateagent

# Launch MCP Server
biblematemcp

# Setup Bible Data
biblematedata

# Launch Web GUI / HTTP Server
biblemateweb

# API Client
biblemateapi -h
```

**Access Web Interface:**
- Local: http://localhost:33