ai_verse

ai_verse is an open-source, production-ready AI SDK, Command Line Interface (CLI), enterprise REST API server, and containerized microservice platform for Python.

---

Features

• Multi-Provider Engine: Supports OpenRouter, OpenAI, Anthropic, Google Gemini, xAI Grok, Local Ollama, and Azure OpenAI.
• Automatic Fallback Chain: Transparent failover across backup providers if primary models experience downtime.
• AI Security Scanners: Integrated scanners for SMS Smishing, WhatsApp Scams, Phishing Emails, Websites, Payment Receipts, QR Codes, and Android APK Malware.
• Document & Vision Intelligence: 4-stage PDF/OCR extraction pipeline (PyMuPDF -> pdfplumber -> pypdf -> pytesseract) for ATS Resume Analysis and Receipt Processing.
• Voice Intelligence: Real speech-to-text audio transcription powered by faster-whisper.
• Enterprise REST API Server: Async FastAPI server (/api/v1) with OpenAPI/Swagger documentation (/docs) and file upload endpoints.
• Rich CLI Tool: Command-line application ai-verse powered by Typer and Rich.
• Plugin Framework: Dynamic plugin loader, manager, and lifecycle hooks (before_request, after_request, before_scan, after_scan).
• Caching System: High-performance in-memory (MemoryCache) and persistent disk (DiskCache) caching with TTL support.
• Production Containerization: Multi-stage Docker image running under non-root user appuser (UID 10001) with healthchecks.

---

Architecture

                  ┌───────────────────────────────┐
                  │       AI Facade (AI())        │
                  └──────────────┬────────────────┘
                                 │
         ┌───────────────────────┼───────────────────────┐
         ▼                       ▼                       ▼
┌──────────────────┐   ┌──────────────────┐   ┌──────────────────┐
│  Security Scans  │   │     Doc & Vision │   │Voice Intelligence│
└──────────────────┘   └──────────────────┘   └──────────────────┘
         │                       │                       │
         └───────────────────────┼───────────────────────┘
                                 ▼
                     ┌───────────────────────┐
                     │   Provider Factory    │
                     └───────────┬───────────┘
                                 │
       ┌───────────┬───────────┼───────────┬───────────┐
       ▼           ▼           ▼           ▼           ▼
┌─────────────┐┌─────────┐┌──────────┐┌─────────┐┌───────────┐
│ OpenRouter  ││ OpenAI  ││Anthropic ││ Gemini  ││  Ollama   │
└─────────────┘└─────────┘└──────────┘└─────────┘└───────────┘

---

Installation & Clone

git clone https://github.com/i-amshifa-06/ai_verse.git
cd ai_verse
pip install ai_verse

For extra features:

# Install with audio processing support (faster-whisper)
pip install ai_verse[audio]

# Install with document OCR support (pytesseract & pdfplumber)
pip install ai_verse[ocr]

---

Environment Setup

Copy .env.example to .env or set your API key:

export OPENROUTER_API_KEY="sk-or-v1-your_openrouter_api_key_here"

For other providers:

• OPENAI_API_KEY: OpenAI API Key
• ANTHROPIC_API_KEY: Anthropic Claude API Key
• GOOGLE_API_KEY: Google Gemini API Key
• XAI_API_KEY: xAI Grok API Key
• OLLAMA_BASE_URL: Local Ollama endpoint (default http://localhost:11434)

---

Quick Start Examples

1. Python SDK

from ai_verse import AI

# Initialize AI facade with OpenAI (or default OpenRouter)
ai = AI(provider="openai")

# Chat Completion
response = ai.chat("Explain zero trust network architecture in 2 sentences.")
print(response.data["text"])

# SMS Smishing Scan
sms_res = ai.scan_sms("URGENT: Your account is locked. Verify at http://bit.ly/fake")
print(f"Risk Score: {sms_res.data['risk_score']}/100 | Risk Level: {sms_res.data['risk_level']}")

# Resume Analysis
resume_res = ai.analyze_resume("resume.pdf", job_description="AppSec Engineer")
print(f"ATS Score: {resume_res.data['ats_score']}%")

---

2. Command Line Interface (CLI)

ai-verse chat "Explain quantum computing in simple terms."
ai-verse scan sms "Verify account at http://bit.ly/fake"
ai-verse resume analyze resume.pdf --job-description "AppSec Engineer"
ai-verse doctor

---

3. FastAPI REST API Server

uvicorn ai_verse.api.main:app --host 0.0.0.0 --port 8000 --reload

Visit http://localhost:8000/docs for Swagger UI.

---

4. Production Docker

docker build -f docker/Dockerfile -t ai-verse:latest .

docker run -d --name ai-verse-server \
  -p 8000:8000 \
  -e OPENROUTER_API_KEY="your_api_key_here" \
  ai-verse:latest

---

Showcase & Frontend Integrations

Complete cross-platform showcase examples available under examples/showcase/:

• React / Next.js: examples/showcase/nextjs_route_snippet.ts
• Flutter: examples/showcase/flutter_client.dart
• Electron: examples/showcase/electron_preload.js
• Node.js: examples/showcase/nodejs_client.js

---

Documentation

Full documentation is available at https://i-amshifa-06.github.io/ai_verse or under docs/:

• Developer Guide
• Provider Guide
• Plugin Guide
• API Reference
• Benchmarks

---

Contributing

We welcome community contributions! Please read CONTRIBUTING.md and CODE_OF_CONDUCT.md.

---

License

ai_verse is licensed under the MIT License.