Skip to content

Latest commit

Β 

History

9 Commits

Folders and files

NameName
Last commit message
Last commit date
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

CollabForge AI

Research. Score. Create. Close.

Creator intelligence, built on live evidence β€” powered by Anakin Wire & the Universal Scraper.


Live App Status Release Gate


Python FastAPI JavaScript Anakin OpenAI ElevenLabs FFmpeg

AWS Docker DynamoDB S3 Tests API No Fake Data


▢️ Watch the Video Demo

πŸ”— https://youtu.be/oyJnl0eKHLY


πŸ”— Live deployment

Surface URL
🌐 Web app (CloudFront) https://d2l3jsjzyhefqq.cloudfront.net
❀️ Health check https://d2l3jsjzyhefqq.cloudfront.net/health
🧠 Runtime capabilities https://d2l3jsjzyhefqq.cloudfront.net/api/v1/system/capabilities
πŸ“š Interactive API docs https://d2l3jsjzyhefqq.cloudfront.net/docs
🎬 Creator Studio https://d2l3jsjzyhefqq.cloudfront.net/app.html?workspace=creator
🏒 Brand Intelligence https://d2l3jsjzyhefqq.cloudfront.net/app.html?workspace=brand
πŸ€– Collab Autopilot https://d2l3jsjzyhefqq.cloudfront.net/app.html?workspace=brand&view=autopilot

Region: eu-west-1 Β· Backend: ECS Fargate behind an ALB, fronted same-origin by CloudFront (/api/* β†’ ALB). /health returns {"status":"ok"}.


πŸŽ₯ Video Demo

▢️ Watch the demo β€” https://youtu.be/oyJnl0eKHLY


🎯 What it does

CollabForge AI is a two-sided platform for the creator economy where every step is grounded in live public evidence β€” no vanity metrics, no stale databases, no synthetic data.

Product For What you get
🎬 Creator Studio Creators Live trend discovery, script studio, hook lab, social content packs, real ElevenLabs voiceovers, AI reel/storyboard + FFmpeg MP4, virality heuristic
🏒 Brand Intelligence Brands Evidence-backed creator dossiers, explainable fit score, comparison, ROI scenarios, outreach drafts, campaign brief, contract template, Campaign Room
πŸ€– Collab Autopilot Brands One guided run β†’ streamed 10-stage pipeline β†’ full Campaign Launch Pack, saved to the Campaign Room

πŸ’‘ The problem β†’ the solution

Brands pick influencers on gut feel, stale databases and vanity metrics. Creators guess at trends. Both waste weeks on research, outreach and paperwork that follows the same pattern every time.

CollabForge grounds every step in live public evidence:

  1. Business DNA β€” the brand's public website is scraped (Anakin Universal Scraper, browser mode + AI JSON extraction) into an editable profile.
  2. Creator Deep Research β€” a creator name becomes a dossier: real recent videos with views, engagement signals, public sentiment from news/Reddit/web, and visible sponsor history β€” each fact carrying an evidence link.
  3. Explainable Fit Score β€” 25% relevance Β· 20% engagement Β· 15% consistency Β· 15% brand safety Β· 15% sponsor compatibility Β· 10% budget fit. Missing data lowers confidence; it is never replaced with invented values.
  4. Deal Documents β€” personalized outreach (never auto-sent), campaign brief, editable contract template (with a clear not-legal-advice notice).
  5. ROI Scenario β€” a simulator with fully editable assumptions, not a "predicted revenue" claim.

🟣 Why Anakin is essential

Need Anakin product How it's used Live status
Business website understanding Universal Scraper (AI JSON extraction) Business DNA βœ… live
Topic research with citations Search API (POST /v1/search) Trend radar, sponsor history, creator discovery βœ… live
Creator channel + recent videos Universal Scraper on public YouTube pages; Search discovers the real channel URL Creator resolver βœ… live
Structured YouTube/News/Reddit reads Wire (yt_*, gn_*, rt_*) β€” 44 verified actions Content intelligence when Wire is up ⚠️ degraded upstream β†’ auto-fallback to Scraper/Search

The backend calls the hosted Anakin REST API (https://api.anakin.io/v1) with a server-side ANAKIN_API_KEY. MCP was used only for development-time discovery β€” the deployed system has no MCP dependency. Verified Wire action IDs (never invented) live in backend/data/anakin_actions.json.

A runtime capability registry (GET /api/v1/system/capabilities) probes what is actually live and the UI only shows enabled features. Platforms without a reliable source (Instagram, TikTok, X) are explicitly disabled β€” never faked.


πŸ—οΈ Architecture

                        β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
   Browser ──HTTPS──►   β”‚  CloudFront  (E1K9WW29XTY2AP)            β”‚
                        β”‚   β”œβ”€β”€ /            β†’ S3 (private, OAC)   β”‚  vanilla-JS frontend
                        β”‚   └── /api/* /health /docs β†’ ALB origin  β”‚
                        β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”¬β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜
                                             β”‚ (same-origin proxy)
                        β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β–Όβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
                        β”‚  ALB  collabforge-alb  β†’  ECS Fargate     β”‚
                        β”‚  service: collabforge-backend  (FastAPI)  β”‚  image: ECR :latest
                        β”‚   β”œβ”€β”€ Anakin REST  (Wire / Scraper / Search)   server-side key
                        β”‚   β”œβ”€β”€ OpenAI (reasoning + images) Β· ElevenLabs (voice)
                        β”‚   β”œβ”€β”€ FFmpeg (reel MP4 composition)
                        β”‚   └── DynamoDB (campaign rooms) Β· S3 (media)
                        β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜

AWS resources (account 824604027501, eu-west-1):

Resource Name / ID
CloudFront E1K9WW29XTY2AP β†’ d2l3jsjzyhefqq.cloudfront.net
Frontend S3 (private, OAC) collabforge-frontend-824604027501
ALB collabforge-alb-1772822941.eu-west-1.elb.amazonaws.com
ECS cluster collabforge Β· service collabforge-backend (Fargate)
Container registry ECR collabforge-backend:latest
Database DynamoDB collabforge-campaigns
Media S3 collabforge-media-824604027501

ℹ️ App Runner is not available on this account (SubscriptionRequiredException), so the backend runs on ECS Fargate + ALB. Deploy scripts live in scripts/.


πŸ”’ Data-source truth model

Every research fact is an evidence object with source, url, retrieved_at, data_method (anakin_wire | anakin_scrape | anakin_search | heuristic | llm_over_evidence) and confidence. The UI labels facts LIVE / ESTIMATED / UNAVAILABLE. There is no synthetic fallback anywhere β€” failed sources produce explicit partial results (e.g. Autopilot shows "research failed for X" rather than inventing a dossier).


⚑ Quick start (local)

# Backend
cd backend
pip install -r requirements.txt
cp .env.example .env        # fill ANAKIN_API_KEY, OPENAI_API_KEY (+ optional ELEVENLABS_API_KEY)
uvicorn main:app --port 8001

# Frontend (separate terminal)
cd frontend
python -m http.server 3000
# open http://localhost:3000

Required in production: ANAKIN_API_KEY, OPENAI_API_KEY. Everything else is optional β€” a missing optional provider disables only its capability. FFmpeg enables reel MP4 composition (bundled in the Docker image). See backend/.env.example.


☁️ Deploy to AWS

# Backend β†’ Docker build β†’ ECR β†’ ECS Fargate rolling update (updates the existing service)
AWS_REGION=eu-west-1 FRONTEND_ORIGIN=https://d2l3jsjzyhefqq.cloudfront.net \
  bash scripts/deploy_backend_aws_ecs.sh

# Frontend β†’ S3 sync β†’ CloudFront invalidation (updates the existing distribution)
AWS_REGION=eu-west-1 BACKEND_URL=http://collabforge-alb-1772822941.eu-west-1.elb.amazonaws.com \
  bash scripts/deploy_frontend_aws.sh

PowerShell wrappers: scripts/deploy_backend_aws.ps1, scripts/deploy_frontend_aws.ps1. Secrets are read from backend/.env at deploy time and injected as runtime env β€” never baked into the image or printed. No Firebase/GCP runtime dependency remains (historical configs archived under legacy/).


πŸ”Œ API

Interactive docs at /docs. Key routes:

GET  /health
GET  /api/v1/system/capabilities
POST /api/v1/business/analyze
POST /api/v1/creators/{discover|research|compare|reputation|sponsor-history|rate-estimate}
POST /api/v1/creators/research/stream                       (SSE)
POST /api/v1/campaigns/{roi-scenario|brief|outreach|contract}
GET/POST/PUT /api/v1/campaigns[/{id}]
POST /api/v1/pipeline/preview Β· /api/v1/pipeline/preview/stream   (SSE)
POST /api/v1/autopilot/run                                  (SSE, 10 stages)
POST /api/v1/trends/discover Β· /api/v1/content/* Β· /api/v1/virality/*
GET  /api/v1/media/voices Β· POST /api/v1/media/{voice|reel}
POST /api/v1/chat/                                          (Forge assistant)

βœ… Testing & release evidence

cd backend && python -m pytest tests -q        # 39 passed
Area Result
Backend API contract 37/37 endpoints pass Β· no 500 on valid flows Β· SSRF/XSS/oversize β†’ structured 4xx
Unit/integration 39 passed / 0 failed
Anakin live Scraper βœ… Β· Search βœ… (distinct queries β†’ distinct real URLs) Β· Wire ⚠️ degraded upstream (honestly reported)
Pipeline / SSE text/event-stream, incremental, backend-driven
Autopilot E2E (live prod) 10 stages, real evidence, saved to Campaign Room, honest partial-failure reporting
Chatbot (Forge) POST /api/v1/chat/ 200, accurate, non-hallucinated
Frontend 0 broken-endpoint buttons Β· no fake data as live Β· no secrets in bundle Β· 0 console errors
Security SSRF/path-traversal/XSS-escape/log-redaction all pass

Verdict: PASS with approved non-blocking exceptions (Anakin Wire degraded upstream, honestly reported). Verified live against production.


πŸŽ₯ Demo flow

The flagship Autopilot run researches real Indian creators (Technical Guruji, Tech Burner, Gaurav Chaudhary) live for a Croma gaming-smartphone launch with a β‚Ή1,50,000 budget. Nothing about any creator is hardcoded β€” every fact carries an evidence link.


⚠️ Limitations

Highlights: YouTube-focused creator research (other platforms lack a reliable source and are disabled, not faked); Anakin Wire execution is degraded upstream, so the live Scraper + Search paths are the active default; rate estimates are benchmark-based ranges, not quotations; contracts are AI-generated templates requiring counsel review.


πŸ›‘οΈ Responsible use

CollabForge analyzes publicly available information only. Sentiment findings are labelled public sentiment signals, not facts. No sensitive demographic attributes are inferred. Outreach is drafted, never sent automatically. Contracts are AI-generated templates requiring counsel review.


Built for the Anakin Hackathon 2026 Β· Research. Score. Create. Close.

About

No description, website, or topics provided.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages