Mystique1337/naija-petro

Nigeria-aware petroleum-engineering AI: fine-tuned Qwen3 (8B/32B) models plus a citation-grounded, self-updating RAG assistant with exact engineering calculators. Served on Modal. # 🛢️ Naija-Petro ### A Nigeria-aware petroleum-engineering AI Fine-tuned **Qwen3** models plus a dynamic, citation-grounded **RAG** assistant with exact engineering calculators. Live app · What it is · Features · Models · Quick start · API · Dataset Built by **Ashinze Emmanuel** · GitHub · Hugging Face --- > [!NOTE] > Naija-Petro produces **decision support** for research and education. Validate every figure with qualified > engineers and primary sources before any operational decision. ## What this is Naija-Petro is a pair of Qwen3 models fine-tuned (QLoRA via Unsloth) on 20,000+ synthetic petroleum-engineering instruction-response pairs, plus the full data pipeline that produced them and a production retrieval-augmented assistant. The base models learned **general, global** petroleum knowledge (drilling, reservoir, production, completions, EOR, well testing, geoscience). They are strong on fundamentals but weak on **Nigeria-specific** facts: regulation, the Petroleum Industry Act 2021, NUPRC, NMDPRA, NNPC, local fields, and fiscal terms. The RAG layer closes that gap. It fetches authoritative Nigerian sources on demand, converts them to clean markdown, cites them, and grows its own knowledge base as it is used. For numeric questions it calls deterministic calculators so the figures are exact, not estimated. Live app: **naija-petro.shinzii.tech** (also at `peniel-tish--naija-petro.mo…`) ## Features - **Dynamic, self-updating RAG.** Hybrid retrieval (dense vectors plus Postgres full-text, fused with Reciprocal Rank Fusion). When local coverage is weak it fetches live from authoritative Nigerian sources, ingests them, and re-retrieves; a background job keeps growing the store after every query. - **Verifiable citations.** Inline numbered citations and a sources panel with site favicons and trust tiers (official, reference, news). - **Engineering calculators (tool calling).** For a computational question the model …