biblia 0.6.0
Bible Study Assistant for Christian Education and Research
Requires Python: >=3.8
Keywords: bible, ai, research, spirituality, education, assistant

# Biblia: Bible Study AI Assistant 🤖📚

An intelligent assistant for biblical study and spiritual growth that combines modern AI with scriptural wisdom, featuring beautiful terminal-based UI.

![Biblia Terminal UI](docs/images/terminal_ui.png)

## ✨ Features

- **Rich Terminal Interface**: Beautiful, colorful console output with proper formatting of headings, lists, and emphasis
- **AI-Powered Biblical Teaching**: Generate in-depth theological insights on any biblical topic
- **Daily Verse Devotionals**: Receive daily verses with AI-generated devotional content
- **Spiritual Reflections**: Create meaningful reflections on biblical passages and teachings
- **Markdown Export**: Save your study sessions in beautifully formatted Markdown files
- **Google Gemini Integration**: Leverages Google's powerful Gemini AI model for theological analysis

## 📸 Screenshots

<details>
<summary>Click to see Biblia in action</summary>

### Daily Verse
![Daily Verse](docs/images/verse.png)

</details>

## 🚀 Installation

### From PyPI (Recommended)

```bash
pip install biblia
```

### From Source

```bash
git clone https://github.com/ashioyajotham/bible.git
cd bible
pip install -e .
```

## 🔑 Configuration

Create a `.env` file in your project directory:

```env
GEMINI_API_KEY=your_gemini_key
SERPER_API_KEY=your_serper_key  # For web search capabilities
ESV_API_KEY=your_esv_key        # For Bible verse lookup
```

## 📖 Usage

### Start Interactive Mode

```bash
bible
```

### Available Commands

- `teach (t)`: Get biblical teaching on a topic
- `verse (v)`: Get daily verse with devotional
- `reflect (r)`: Reflect on recent study
- `export (e)`: Export study session
- `help (h)`: Show help message
- `exit (q)`: Exit application

## 🏗️ Architecture

```mermaid
graph TB
    User([User]) --> CLI[Command Line Interface]
    CLI --> BA[Bible Agent]
    
    subgraph "Core Components"
        BA --> MS[Model Selector]
        BA --> SA[Search Agent]
        BA --> SS[Study Session]
        
        MS --> GM[Gemini Model]
        MS --> HF[HuggingFace Model]
        
        SA --> SP[Serper Service]
        SA --> MA[Model Analysis]
    end
    
    subgraph "Features"
        BA --> VS[Verse Service]
        BA --> TS[Teaching Service]
        BA --> RS[Reflection Service]
        BA --> AS[Analysis Service]
    end
    
    subgraph "Utils & Formatting"
        BA --> CF[Console Formatter]
        BA --> MF[Markdown Formatter]
        SS --> EX[Export System]
    end
```

## 🛠️ Technical Components

- **Rich Console Interface**: Beautiful terminal UI with color, formatting, and proper Markdown rendering
- **Agent System**: Modular design with specialized agents for different tasks
- **AI Integration**: Google Gemini model for high-quality theological insights
- **Session Management**: Persistent study sessions that can be exported
- **Error Handling**: Graceful error handling and user-friendly messages

## 🙏 Contributing

Contributions are welcome! Please read our [contributing guidelines](CONTRIBUTING.md) for more details.

## 📜 License

MIT License - See [LICENSE](LICENSE) for more details.

## ⚠️ Note

This is an AI assistant tool meant to aid in Bible study, not replace traditional study methods or spiritual guidance.