Skip to content

Latest commit

 

History

History
120 lines (84 loc) · 3.22 KB

README.md

File metadata and controls

120 lines (84 loc) · 3.22 KB

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

✨ 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

Daily Verse

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
Loading

🛠️ 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.