Metadata-Version: 2.4
Name: bbible
Version: 0.2.0
Summary: Explore the Bible by verse or by meaning — with multi-version and AI topic search
Home-page: https://github.com/Biyi003/bbible
Author: Biyi Adebayo
Project-URL: Documentation, https://github.com/Biyi003/bbible#readme
Project-URL: Source, https://github.com/Biyi003/bbible
Project-URL: Bug Tracker, https://github.com/Biyi003/bbible/issues
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Topic :: Religion
Requires-Python: >=3.6
Description-Content-Type: text/markdown
License-File: LICENSE
Dynamic: author
Dynamic: classifier
Dynamic: description
Dynamic: description-content-type
Dynamic: home-page
Dynamic: license-file
Dynamic: project-url
Dynamic: requires-python
Dynamic: summary

# bbible

**bbible** is a Python library for exploring the Bible through both direct verse lookup and AI-powered semantic search.

> 🙏 Find what you’re looking for — whether it’s by reference or meaning.

---

## 🔥 Why bbible?

- 🧠 **Semantic topic search**: Find verses by concept, not just keywords.  
  _e.g., `.topic("grace")` returns verses about grace, trust, and forgiveness._
- 🔍 **Verse-level lookup**: Fetch specific verses or ranges by book, chapter, and verse.
- 📚 **Multi-version support**: Works with multiple translations (`nkjv`, `kjv`, more coming).
- 💬 **Readable output**: Cleanly formatted and suitable for quoting or presentation.

---

## 🚀 Quick Example

```python
import bbible

# Get a verse or passage
print(bbible.get_verse("john", 3, 16))
print(bbible.get_verse("psalms", 23, (1, 6)))

# Semantic search by topic
print(bbible.topic("peace", top_k=3))
print(bbible.topic("trust in God", version="kjv", top_k=5))
