Welcome to the COMPLETE AI-Powered Anime Ecosystem! 🎌

"You now command the complete anime ecosystem. This package combines a production-grade RAG Recommendation Engine with the viral Anime Receipts Generator giving you the ultimate toolkit to build, launch, and dominate the anime discovery market."

📦 What's Included

✅ Complete AI Recommendation System

• RAG Pipeline - Semantic search engine
• FastAPI Backend - Production-ready API
• Streamlit Frontend - Beautiful UI
• Pre-built FAISS vector index (instant search)
• 8,248 anime dataset (parquet format)
• Complete documentation

✅ Anime Receipts Generator (NEW!)

• Receipt Backend API - FastAPI endpoints for receipt generation
• Receipt Frontend - Streamlit app for creating viral receipts
• Multi-Format Export - Premium, Instagram, Twitter, Facebook optimized
• Async HTML-to-PNG conversion (Playwright + Batch rendering)
• Customizable back card images
• High-quality PNG output with auto-cropping
• Smart episode distribution (multiple cards support)

✅ 8,248 High-Quality Anime Images

• Poster Images (vertical format, optimized)
• Backdrop Images (horizontal format for slider view)
• Logo Images (anime branding)
• Total: ~2.3GB of optimized assets
• Perfect for receipt generation & UI

✅ Production-Ready Codebase

• Clean, documented Python code
• Security best practices
• Error handling & logging
• CORS-enabled for cross-origin requests
• Scalar API documentation (Scalar UI)
• Custom 404 pages

✅ Documentation

• Setup guides (Windows, Mac, Linux)
• API documentation
• Troubleshooting guide

💻 System Requirements

Minimum Specs (Lightweight Mode):

• RAM: 4GB+
• CPU: 4+ Cores
• Storage: 5GB+ (for models, dataset, and images)
• OS: Windows 10/11, macOS (M1/M2 supported), or Linux (Ubuntu 20.04+)
• Python: 3.10 or higher

Recommended Specs (Full AI Power):

• RAM: 8GB+
• GPU: NVIDIA GPU (4GB+ VRAM) or Apple Silicon (M1/M2/M3)
• Storage: 8GB+ (to store the generative LLM)

⚠️ Note on Performance:

The system automatically detects your hardware:

• With GPU: Enables HyDE (Generative AI) for smarter intent translation (e.g., understanding "No ecchi" logic).
• CPU Only: Automatically switches to Lightweight Mode (Vector Search + Keyword Boosting) to ensure fast performance without lag.

🎨 Anime Receipts Generator Features

Create Viral Social Media Content

Beautiful Receipt Cards:

• Two-sided receipt design (front + back)
• Anime poster on front card
• Episode list on back card (receipt-style)
• Japanese title branding
• Studio & director credits
• Professional typography

Smart Multi-Card System:

• Automatically splits long anime into multiple cards
• Episode distribution logic (15-25 episodes per card)
• Card numbering & episode tracking
• Perfect for 12-episode to 1000+ episode anime

Multi-Platform Export:

• 🎬 Premium - Variable high-quality resolution
• 📸 Instagram - 1080x1080 square posts
• 🐦 Twitter - 1200x675 landscape
• 📘 Facebook - 1200x630 landscape

Advanced Rendering:

• Async batch HTML-to-PNG conversion
• Playwright-powered (Chrome, Firefox, WebKit)
• OS-agnostic (Windows, Mac, Linux)
• Automatic whitespace cropping
• High-DPI output (device_scale_factor=3)
• Concurrent rendering (6 pages simultaneously)

Customization Options:

• Upload custom back card images
• Fuzzy search anime by title
• Browse by anime ID
• Real-time preview
• Session-based management

📸 Screenshots

🖼️ Beautiful UI Design

🎨 Grid View - Apple-Inspired Cards

• Gorgeous card design with smooth animations
• Color-coded similarity badges
• Hover for instant info overlay
• 18+ content warnings

🎬 Slider View - Immersive Experience

• Full-screen backdrop images
• Glassmorphism design
• Thumbnail navigation strip
• Keyboard shortcuts (← →)

🎯 Smart Filters & Controls

• Dynamic filter updates (no re-search needed!)
• Year range: 1917-2025
• Rating threshold: 0-10
• Anime type selector
• Real-time API statistics

🔍 Similar Anime Discovery

• Find anime like your favorites
• Recursive exploration
• Color-coded match percentages
• Instant results (<0.1s)

🚀 Quick Start (10 Minutes)

1️⃣ Install Everything

# Create virtual environment
python -m venv testenv
source testenv/bin/activate  # On Windows: testenv\Scripts\Activate

# Install packages
pip install -r requirements.txt

2️⃣ Start Backend APIs (Two Terminals)

Terminal 1 - Recommendation API:

uvicorn AiMi_Recommendation_System:app --reload --port 8000 # Make sure to update .env file whenever you change the port address

Terminal 2 - Receipts API:

# From root directory
uvicorn AiMi_Anime_Receipts_Generator:app --reload --port 1234 # Make sure to update .env file whenever you change the port address

3️⃣ Start Frontends (Two More Terminals)

Terminal 3 - Recommendation Frontend:

streamlit run AiMi_Recommendation_System/frontend/streamlit_recommendation_frontend.py

Terminal 4 - Receipts Frontend:

streamlit run AiMi_Anime_Receipts_Generator/receipt_frontend.py

4️⃣ Open Browser

• Recommendation Engine: http://localhost:8501
• Receipts Generator: http://localhost:8501
• Recommendation API Docs: http://localhost:8000/aimi-scalar
• Receipts API Docs: http://localhost:1234/aimi-scalar

That's it! Your complete anime empire is live! 🚀

🎬 Receipts Generator Workflow

Step 1: Search & Select

User searches "Demon Slayer"
    ↓
Fuzzy search finds anime
    ↓
Display anime metadata & poster

Step 2: Customize

Optional: Upload custom back card image
    ↓
Or use default anime logo

Step 3: Generate

Create HTML receipts (front + back)
    ↓
Store in organized directory structure
    ↓
Ready for conversion

Step 4: Convert & Export

Premium (High-Quality) ──────┐
Instagram (1080x1080) ────────├─→ Download individually
Twitter (1200x675) ───────────┤   or ZIP all files
Facebook (1200x630) ──────────┘

🛠️ Tech Stack

Backend

• FastAPI - Modern async Python API
• Playwright - Browser automation (async)
• Sentence Transformers - Nomic v1.5 embeddings
• FAISS - Vector similarity search
• Pandas - Data processing
• DiskCache - Query caching
• Uvicorn - ASGI server

Frontend

• Streamlit - Beautiful Python web framework
• Playwright - Browser automation (async)
• Pillow - Image processing
• NumPy - Array operations
• Custom CSS - Apple-inspired design
• Responsive Layout - Works on all devices
• Interactive Components - Sliders, dropdowns, cards

AI/ML

• Nomic v1.5 - 768-dimensional embeddings
• RAG Architecture - Retrieval-Augmented Generation
• Cosine Similarity - Matching algorithm
• Semantic Search - Meaning-based queries
• RapidFuzz - Fuzzy matching

📁 Project Structure

aimi-rag-system
├── AiMi_Recommendation_System/
│    ├── backend/
│    │   ├── __init__.py                           # Marks AiMi_Recommendation_System as a Python package and exposes core app objects.
│    │   ├── api_recommendation_backend.py         # FastAPI server
│    │   └── robust_rag_pipeline_rars.py           # RAG pipeline
│    ├── frontend/
│    │   ├── streamlit_recommendation_frontend.py  # AiMi UI
│    │   └── splash_screen_loading.html            # Intro animation
│    ├── __init__.py                               # Backend package for AiMi. Contains FastAPI API and RAG pipeline modules.
│    └──.env                                       # config file
├── assets/
│    ├── fonts/
│    │   ├── Macondo                               # font family
│    │   ├── Nunito                                # font family
│    │   ├── Poppins                               # font family
│    │   ├── Roboto                                # font family
│    │   └── Syne                                  # font family
│    ├── screenshots/
│    │   ├── screenshot1.png                       # png image
│    │   ├── screenshot2.png                       # png image
│    │   ├── screenshot3.png                       # png image
│    │   ├── screenshot4.png                       # png image
│    │   └── and so on...                          # png image
│    ├── static/
│    │   ├── 404_page.html                         # 404 html file
│    │   ├── image1.png                            # png image
│    │   ├── image2.png                            # png image
│    │   └── image3.png                            # png image
├── Dataset/
│    ├── anime_index/
│    │   ├── anime_dataset_nomic.parquet           # Complete parquet dataset file
│    │   ├── faiss_nomic.index                     # faiss index
│    │   └── metadata_nomic.json                   # model metadata
│    ├── Backdrop Images/
│    │   ├── image1.png                            # png image
│    │   ├── image2.png                            # png image
│    │   ├── image3.png                            # png image
│    │   └── and so on...                          # png image
│    ├── Logo Images/
│    │   ├── image1.png                            # png image
│    │   ├── image2.png                            # png image
│    │   ├── image3.png                            # png image
│    │   └── and so on...                          # png image
│    ├── Poster Images/
│    │   ├── image1.png                            # png image
│    │   ├── image2.png                            # png image
│    │   ├── image3.png                            # png image
│    │   └── and so on...                          # png image
├── AiMi_Anime_Receipts_Generator/
│    ├── static/
│    │   ├── 404_page.html                         # 404 html file
│    │   ├── image1.png                            # png image
│    │   ├── image2.png                            # png image
│    │   ├── image3.png                            # png image
│    │   ├── image4.png                            # png image
│    │   └── image5.png                            # png image
│    ├── generated_receipts/
│    │   ├── facebook                              # receipts directory
│    │   ├── instagram                             # receipts directory
│    │   ├── premium                               # receipts directory
│    │   └── twitter                               # receipts directory
│    ├── receipt_backend.py                        # FastAPI server
│    ├── receipt_frontend.py                       # Receipts UI
│    ├── __init__.py                               # Backend package for AiMi Receipts Generator. Contains backend module.
│    └──.env                                       # config file
├── AiMi_UI_Demo/                                  # directory including demo UI videos and .webp files
│    ├── intro.mp4                                 # loading screen
│    ├── UI_clip1.mp4                              # AiMi UI Demo 
│    ├── UI_clip2.mp4                              # AiMi UI Demo
│    ├── intro_output.webp                         # loading screen
│    ├── UI_clip1_output.webp                      # AiMi UI Demo 
│    └── UI_clip2_output.webp                      # AiMi UI Demo
├── INSTALLATION_GUIDE.md                          # Comprehensive Guide
├── license.md                                     # Must read license
├── thank_you_card1_tier3.png                      # Token of appreciation (Thank You Card)
├── thank_you_card2_tier3.png                      # Token of appreciation (Thank You Card)
└── requirements.txt                               # Containing all important libraries

💎 Monetization Ideas

With Tier 3, You Can

1. SaaS Platform ($5-15/month/user)

• Host your own anime recommendation website
• White-label the receipts generator
• Charge users for premium exports
• Add your own branding & ads

2. API Service ($500-5000/month)

• Offer API access to other apps
• Bulk anime recommendations
• Custom receipt generation
• Per-request billing

3. Content Creation Tool ($2-10/receipt)

• Fiverr gigs: "I'll create custom anime receipts"
• Sell receipt templates on Etsy
• Gumroad: Anime receipt packs
• Patreon: Exclusive receipt previews

4. Integration Services

• Discord Bot: /anime receipt
• Telegram Bot: Anime recommendations
• Twitter Bot: Daily anime receipts
• Slack App: Team anime picks

5. B2B Solutions ($2000-10000/mo)

• Anime streaming platforms (Netflix, Crunchyroll)
• Gaming companies (anime-themed games)
• Merchandise companies (print receipts as collectibles)
• Advertising networks (contextual anime ads)

Realistic Revenue Scenarios

| Scenario | Monthly Revenue |
|----------|-----------------|
| **10 SaaS users** @ $10/mo | $100 |
| **100 Fiverr orders** @ $8 | $800 |
| **50 Etsy sales** @ $5 | $250 |
| **1 B2B contract** | $2,000-5,000 |
| **Small SaaS** (100 users) | $1,000 |
| **Growing Platform** (1,000 users) | $10,000 |
| **Established Service** (10,000 users) | $100,000+ |

🎯 Use Cases

Personal Use

• ✅ Track your anime journey
• ✅ Share taste with friends
• ✅ Create beautiful galleries
• ✅ Gift anime-themed cards

Content Creators

• ✅ YouTube thumbnails
• ✅ Blog post illustrations
• ✅ Podcast cover art
• ✅ Social media graphics

Businesses

• ✅ Anime streaming platforms
• ✅ Merchandise companies
• ✅ Gaming studios
• ✅ Event organizers

Developers

• ✅ Build anime recommendation apps
• ✅ Create personalized playlists
• ✅ Implement semantic search
• ✅ Train ML models

📊 API Endpoints Reference

Recommendation System

• GET /search - Search anime by keywords
• GET /similar/{anime_id} - Find similar anime
• GET /anime/{anime_id} - Get anime details

Receipts Generator

• GET /search-anime - Fuzzy search by title
• GET /anime/{anime_id} - Get full metadata
• GET /anime/{id}/serve-image/{filename} - Poster images
• GET /anime/{id}/serve-image-back/{filename} - Logo images
• PATCH /anime/{id}/update-image - Update image path (admin)

🆘 Quick Troubleshooting

| Issue | Solution |
|-------|----------|
| Port already in use | Change port number in command |
| FAISS index not found | Ensure full Tier 2/3 package extracted |
| Streamlit not starting | Run `pip install streamlit --upgrade` |
| Model download fails | Check internet connection |

Generated Receipt Examples

Front Side (Receipts):

Back Side (Receipts):

💬 Resources

📚 Documentation

• Complete setup guides for all platforms
• API reference with examples
• Deployment tutorials
• Troubleshooting FAQ

🔒 License

🔑 License & Rights

✅ What You CAN Do (Make Money):

• Build a SaaS: Deploy a recommendation site/app and charge users.
• Freelance: Build projects for clients (deploy the app for them).
• Sell Outputs: Sell the receipts, API access, or recommendations.
• White-label: Remove AiMi branding and use your own logos.
• Deploy: Host on any server (AWS, Vercel, DigitalOcean).

❌ What You CANNOT Do (Piracy):

• Resell the Code: You cannot sell the raw source code/zip file itself.
• Open Source: You cannot upload the code to public GitHub/Kaggle.
• Redistribute Data: You cannot sell the raw parquet/index files separately.

See license.md for specific details on Client Work and Asset Usage.

Contact

For licensing questions, commercial usage inquiries, or copyright notices:

aimi.anime.system@gmail.com

Note: For installation help or technical issues, please refer to the documentation and troubleshooting guides included in your download package.

🎉 Thank You

You now have a robust production-ready AI recommendation system.

What's Next?

1. ✅ Download and extract files
2. ✅ Follow the 10-minute quick start
3. 🎨 Customize the UI to match your brand
4. 📸 Generate your first receipts
5. 🚀 Deploy to the cloud
6. 📢 Share your version with the world!
7. 💰 Start earning

I can't wait to see what you build! 🌟

💬 Made with ❤️

Created by Divyanshu Singh - Passionate Programmer & Die Hard Anime Fan

Version 1.0 | Last Updated: 2025

Your success is my success. Now go build something amazing! 🎌

"The best way to predict the future is to build it yourself. With AiMi Tier 3, you have all the tools. What will you create?" — Divyanshu Singh