Skip to content

opensns-dev/opensns

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

23 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

OpenSNS

Open-Source AI Marketing Agent Platform

CI License Docs

Self-hostable AI marketing agent that generates ad creatives from a product URL.
100% open-source. Own your data. No vendor lock-in.


FeaturesDemoQuick StartArchitecturePricingRoadmapCommunity

Demo

OpenSNS Demo

Paste a product URL. Get complete ad campaigns in under 60 seconds.

Why OpenSNS?

The open-source alternative to Zet AI and AdCreative.ai.

OpenSNS Zet AI AdCreative.ai
Self-hosted ✅ Unlimited ❌ Cloud only ❌ Cloud only
Data ownership ✅ You own everything ❌ Vendor lock-in ❌ Vendor lock-in
Naver platforms ✅ 15+ platforms ❌ Limited ❌ None
Pluggable engines ✅ Swap LLM/Image/Video ❌ Fixed ❌ Fixed
Price Free / $9+ $49+/mo $29+/mo

Self-hosted = unlimited generations for free. Run on your own hardware with your own API keys. No per-credit markups. No usage limits.

15+ Naver platform support. The only open-source tool with deep integration for Korea's dominant ad ecosystem.

Pluggable engine architecture. Use OpenAI today, switch to Ollama tomorrow. Swap Fal.ai for ComfyUI. Your choice, your control.

Features

Core AI Pipeline

  • Product Analysis — Scrapes and analyzes product pages to extract features, benefits, and positioning
  • Competitor Research — AI-powered competitive analysis and differentiation strategy
  • Multi-Angle Strategy — Generates multiple marketing angles for testing different approaches
  • Ad Copy Generation — Platform-specific copy optimized for each channel's audience
  • Image Generation — AI-generated product images via Fal.ai, FluxPro, or ComfyUI
  • Video Generation — Image-to-video conversion for TikTok, Reels, and Stories
  • UGC Video — AI avatar videos with HeyGen, D-ID, or self-hosted SadTalker
  • Performance Prediction — AI-powered CTR and engagement forecasting
  • Multi-Platform Optimization — Automatic resizing and formatting for each platform's specs

P0: Essential Tools

  • Template Library — 40+ proven ad templates for quick campaign starts
  • Brand Kit — Store logos, colors, fonts, and brand guidelines for consistent output
  • Direct Publishing — One-click publish to META platforms (Instagram, Facebook)

P1: Growth & Collaboration

  • A/B Testing — Built-in split testing with statistical significance tracking
  • Team Collaboration — Role-based access control (RBAC) for agencies and teams
  • Ad Performance Analytics — Track real performance vs. AI predictions
  • i18n — Full Korean (한국어) and English support

P2: Power User Features

  • Public API — REST API for integrating with external tools and workflows
  • Prediction vs Actual Tracking — Compare AI forecasts with real campaign data
  • Scheduling Calendar — Plan and queue campaigns for optimal timing

P3: Enterprise & White-Label

  • Custom Voice/Avatar — Train custom AI voices and avatars for UGC
  • White-Label — Rebrand OpenSNS for your agency clients
  • Ad Serving — Serve ads directly from OpenSNS (future)

NEW: Latest Additions

  • Product Photography AI — Generate professional product shots from simple inputs
  • AI Content Labeling — Automatic labeling for AI-generated content compliance
  • BYOK Plan — Bring Your Own API Keys on the hosted cloud platform

Quick Start

One-Click Deploy

Deploy on Railway Deploy on Render

Docker Compose (Recommended)

git clone https://github.com/opensns-dev/opensns.git
cd opensns

# Copy and configure environment
cp .env.example .env

# Generate required secrets
# JWT_SECRET_KEY and API_KEY_ENCRYPTION_KEY are required
# Generate with: openssl rand -hex 32

# Start all services
docker compose up -d

# Access the app
# Frontend: http://localhost:3000
# Backend API: http://localhost:8000
# API Docs: http://localhost:8000/docs

Manual Setup

Backend
cd backend
python -m venv venv
source venv/bin/activate  # Windows: venv\Scripts\activate
pip install -r requirements.txt

cp .env.example .env
# Edit .env with your settings

uvicorn app.main:app --reload
Frontend
cd frontend
bun install
cp .env.example .env.local

bun dev

Architecture

graph TB
  subgraph Frontend
    A[Next.js 15 App Router]
  end
  subgraph Backend
    B[FastAPI + LangGraph]
    C[Research Agent]
    D[Strategy Agent]
    E[Copy Generation]
    F[Image Generation]
    G[Video Generation]
    H[UGC Agent]
    I[Performance Predictor]
  end
  subgraph Engines [Pluggable Engines]
    J[LLM: OpenAI / Ollama]
    K[Image: Fal.ai / ComfyUI]
    L[Video: Runway / Fal.ai]
    M[UGC: HeyGen / D-ID / SadTalker]
  end
  subgraph Storage
    N[PostgreSQL / SQLite]
  end
  A -->|REST API + WebSocket| B
  B --> C --> D --> E --> F --> G --> H --> I
  E --> J
  F --> K
  G --> L
  H --> M
  B --> N
Loading

Supported Platforms

Global Platforms

Platform Feed Story Video Shopping
Instagram ✅ Reels
Facebook ✅ Stories
Google Ads ✅ Display
TikTok
YouTube ✅ Shorts
X/Twitter
LinkedIn

Korea (Naver) Platforms

Platform Search Feed Video Shopping
Naver PowerLink
Naver Brand Search
Naver GFA ✅ Native
Naver GFA Banners
Naver Shopping ✅ Product
Naver Brand Zone
Naver TV
Naver Shorts
Naver Blog ✅ Content
Naver Cafe ✅ Content
Kakao Display
Kakao Bizboard

Built With

  • FastAPI — Modern, fast web framework for building APIs
  • LangGraph — Orchestration framework for agent workflows
  • Next.js 15 — React framework with App Router
  • shadcn/ui — Re-usable components built with Radix UI and Tailwind
  • SQLModel — SQL databases in Python, designed for simplicity
  • Fal.ai — Fast image and video generation inference
  • ComfyUI — Powerful and modular diffusion model GUI

Pricing

Plan Price Credits Best For
Free $0 50/mo Trying it out
Basic $9/mo 150/mo Indie marketers
BYOK $15/mo Unlimited Bring Your Own API Keys
Pro $29/mo 500/mo Growing teams (up to 3)
Ultra $59/mo 1,200/mo Agencies (up to 10 seats)

Self-hosted = unlimited for free. When you self-host, you bring your own API keys. You only pay for the actual AI generation costs (OpenAI, Fal.ai, etc.) with no markup. Generate thousands of creatives for the cost of the raw API calls.

BYOK (Cloud) — Use your own API keys on our hosted platform. Unlimited generations for a flat $15/mo infrastructure fee.

Credit costs:

  • 1 image generation = 1 credit
  • 1 video generation = 12 credits

Roadmap

Completed ✅

  • Product analysis from URL
  • Competitor research
  • Multi-angle strategy generation
  • Ad copy for 15+ platforms
  • Image generation (Fal.ai, ComfyUI)
  • Video generation (Runway, Fal.ai)
  • UGC video (HeyGen, D-ID, SadTalker)
  • Performance prediction
  • Multi-platform optimization
  • Template library (40 templates)
  • Brand Kit
  • Direct META publishing
  • i18n (Korean + English)

In Progress 🚧

  • A/B testing framework
  • Team collaboration (RBAC)
  • Ad performance analytics
  • Public API
  • Product Photography AI

Planned 📋

  • Prediction vs actual tracking
  • Scheduling calendar
  • Custom voice/avatar training
  • White-label option
  • AI content labeling

Documentation

Full documentation is available at opensns-dev.github.io/opensns

Community

Development

# Backend tests
cd backend && pytest -v

# Frontend tests
cd frontend && bun test

# E2E tests
cd frontend && bun e2e

# Linting
cd backend && ruff check app/
cd frontend && bun lint

Star History

Star History Chart

License

MIT License — see LICENSE for details.

Contributing

Contributions are welcome! Please read CONTRIBUTING.md for guidelines.


Made with ❤️ by the OpenSNS community

About

No description, website, or topics provided.

Resources

License

Contributing

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors