🎬 CineForge AI Pro

Secure multimodal AI pipeline: Arabic & English scripts → storyboards, animatics, and budget estimates
IBM SkillsBuild AI Builders Challenge — July 2026

---

Overview

CineForge AI Pro turns film scripts (Arabic and English) into:

• Storyboard frames generated via Hugging Face Inference Providers (IBM Granite/watsonx.ai integration planned — see roadmap)
• Motion animatics (MP4/GIF slideshows with transitions)
• Production budget estimates based on scene metadata

All creative assets are protected with AES-256 client-side encryption and C2PA-inspired watermarking.

---

Quick Start

Backend (FastAPI)

cd src/backend
python -m venv venv && source venv/bin/activate
pip install -r ../../requirements.txt
cp ../../.env.example ../../.env   # Fill in your credentials
uvicorn main:app --reload
# API docs: http://localhost:8000/docs

Frontend (Next.js)

cd src/frontend
npm install
cp ../../.env.example .env.local   # Fill in NEXT_PUBLIC_* variables
npm run dev
# App: http://localhost:3000

---

Project Structure

.github/                     ← Copilot instructions, PR template
docs/
├── bob-log/                 ← IBM Bob session screenshots
├── ROADMAP.md               ← Development plan
└── README.md
src/
├── backend/                 ← FastAPI (Python 3.11)
│   ├── main.py
│   ├── routers/             ← health, scripts, generate, animatic, budget
│   ├── services/            ← script_parser, granite, watermark, budget, animatic
│   └── models/              ← Pydantic schemas
└── frontend/                ← Next.js 14 + TypeScript + Tailwind
    ├── app/                 ← Pages: upload, storyboard, judge
    ├── components/          ← Shared UI components (bilingual, RTL-aware)
    └── lib/                 ← crypto.ts, api.ts, i18n.ts
CHARTER.md                   ← Vision, goals, team roles
MEMORY.md                    ← Living memory for AI agents
AGENT.md                     ← Rules for Copilot & AI agents
ARCHITECTURE.md              ← System design
SECURITY.md                  ← Encryption & watermarking rules
CONTRIBUTING.md              ← Team workflow & Bob tagging

---

Team

Role	Responsibility
Data Science Lead	Script parsing, budget estimator
ML Engineer	Hugging Face integration (Granite/watsonx.ai planned), animatic pipeline
Cybersecurity Specialist	AES-256 encryption, C2PA watermarking
Full-Stack Developers	Next.js frontend, FastAPI backend

---

Documentation

• Charter — Vision, goals, success criteria
• Memory — Living context for Copilot & team
• Agent Rules — Rules for AI agents working in this repo
• Architecture — System design
• Security — Encryption & watermarking policy
• Contributing — Team workflow & IBM Bob tagging
• Roadmap — July 2026 milestone plan

---

Built with ❤️ using IBM Bob (Ask/Plan/Code modes)