Metadata-Version: 2.2
Name: biblia
Version: 0.6.0
Summary: Bible Study Assistant for Christian Education and Research
Home-page: https://github.com/ashioyajotham/bible
Author: Victor Jotham Ashioya
Author-email: victorashioya960@gmail.com
Keywords: bible,ai,research,spirituality,education,assistant
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Education
Classifier: Intended Audience :: Religion
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Topic :: Religion
Classifier: Topic :: Education
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: requests>=2.30.0
Requires-Dist: python-dotenv>=1.0.0
Requires-Dist: google-generativeai>=0.3.0
Requires-Dist: colorama>=0.4.6
Requires-Dist: transformers>=4.30.0
Requires-Dist: torch>=2.0.0
Requires-Dist: accelerate>=0.20.0
Requires-Dist: rich>=12.0.0
Dynamic: author
Dynamic: author-email
Dynamic: classifier
Dynamic: description
Dynamic: description-content-type
Dynamic: home-page
Dynamic: keywords
Dynamic: requires-dist
Dynamic: requires-python
Dynamic: summary

# 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.
