biblia 0.5.5

Bible Study Assistant for Christian Education and Research

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.

✨ 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

Click to see Biblia in action

Welcome Screen

Biblical Teaching

Daily Verse

🚀 Installation

From PyPI (Recommended)

pip install biblia

From Source

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

🔑 Configuration

Create a .env file in your project directory:

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

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

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 for more details.

📜 License

MIT License - See 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.