Skip to content

keith-wohnv/odylic-studio

 
 

Repository files navigation

Odylic Studio

AI-powered ad creative generation. Enter a product URL, and the system researches your brand, selects templates, writes copy, and generates on-brand ad creatives.

Important — Read Before Using

API Key Security: This app requires your personal API keys for Google Gemini and Anthropic Claude. Your keys are stored locally on your computer only and are never sent to us or any third party. That said, we cannot guarantee the security of your API keys. We strongly recommend:

  • Create NEW API keys specifically for this app — do not reuse keys from other projects
  • Set spend limits on both accounts immediately after creating your keys
  • Revoke the keys if you stop using the app

Cost Warning: This app makes API calls to generate ads, and each generation costs real money. Costs depend on how many ads you generate, the quality tier you use, and how many resizes you do. As a rough guide:

Action Estimated Cost
Brand research (Claude) ~$0.05–0.15 per research
Ad generation — Fast tier (Gemini) ~$0.01–0.03 per image
Ad generation — Quality tier (Gemini) ~$0.02–0.05 per image
Ad generation — Pro tier (Gemini) ~$0.05–0.10 per image
Resizing an ad to a new size ~$0.02–0.05 per resize
Asset analysis (Claude) ~$0.01–0.03 per image

A typical session generating 10–20 ads with resizes might cost $0.50–$2.00. Heavy usage (50+ ads, multiple brands) could be $5–10+ per session. These are estimates — actual costs vary based on prompt length, image sizes, and current API pricing.

Set spend limits on your API accounts:

We are not responsible for any API charges incurred. By using this app, you acknowledge that you are using your own API keys at your own expense and discretion. Monitor your usage regularly.


Install (one command)

Mac / Linux — open Terminal and paste:

curl -fsSL https://raw.githubusercontent.com/peterquads/odylic-studio/main/install.sh | bash

Windows — open PowerShell and paste:

irm https://raw.githubusercontent.com/peterquads/odylic-studio/main/install.ps1 | iex

Both commands auto-install Git and Node.js if needed, download ~4,000 ad templates, create a Desktop shortcut, and launch the app.

Manual install

Requires Node.js 18+ and Git.

git clone https://github.com/peterquads/odylic-studio.git ~/odylic-studio
cd ~/odylic-studio
npm install
npm start

The app opens at http://localhost:3000.


API Keys Required

You'll need two API keys (both have free tiers). Create new keys just for this app.

  1. Google AI (Gemini)Get key

    • Used for image generation and resizing
  2. Anthropic (Claude)Get key

    • Used for brand research, copy writing, template selection, and QA review

Enter both keys on the Setup page when you first open the app.


How It Works

  1. Brand Research — Enter your product page URL. Claude analyzes your brand, competitors, colors, voice, and audience. Review and edit anything it got wrong, upload your own assets here as well.
  2. Upload Assets — Upload product photos, logos, and inspiration ads — the tool pulls from the site too. More assets = better, more varied ads — especially stickers, icons, backgrounds.
  3. Generate — Choose a quality tier, pick how many ads and which sizes (1:1, 3:4, 9:16), and hit Generate.
  4. Review & Resize — Click any ad to see it full-size. Resize to other aspect ratios with one click. Save and download your favorites.

Quality Tiers

Tier Model Cost Best for
Fast Nano Banana Free tier eligible Quick drafts, testing
Quality Nano Banana 2 Paid Production-ready ads
Pro Nano Banana Pro Paid Highest image quality

Tips

  • You can cancel generation mid-way — already-completed ads are kept
  • Upload competitor ads as inspiration under the first page's advanced settings section — the AI will analyze their strategy and riff on it
  • Upload your own past ads as custom templates for the AI to follow
  • Errors show as pop-up notifications in the bottom-right corner

Video Tutorial

Watch the walkthrough on Loom


What's Included

  • ~4,000 ad templates downloaded automatically during install
  • Upload your own templates via Advanced Settings on the Setup page

Tech Stack

  • Frontend: React 19 + TypeScript + Vite + Tailwind CSS
  • State: Zustand (localStorage + IndexedDB for persistence)
  • AI: Claude (Anthropic) for strategy/copy, Gemini (Google) for image generation
  • No backend required — runs entirely in the browser

Troubleshooting

Problem Fix
"Node.js not found" Install from nodejs.org and re-run the install command
"Git not found" Install from git-scm.com and re-run
Ads fail to generate Check your Gemini API key is valid. Free tier only supports the Fast model.
App won't open Run cd ~/odylic-studio && npm run dev in Terminal, then open http://localhost:3000
Uninstall Delete the ~/odylic-studio folder and the Desktop shortcut

Questions? DM me on X @Peter_Quadrel

About

Brand image gen

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages

  • TypeScript 91.8%
  • Shell 3.1%
  • PowerShell 2.8%
  • Batchfile 1.4%
  • CSS 0.6%
  • HTML 0.2%
  • JavaScript 0.1%