Getting started · ~10 minutes
How to use OpenAdKit
From install to your first AI-generated ad in about 10 minutes. Follow the five steps in order — total time is ~10 minutes including the AI provider signup.
Step 1 · 30 seconds – 5 minutes
Get OpenAdKit running
Pick one of the two install paths. Both are completely free.
Path A — Hosted (recommended for non-developers)
Open the GitHub repo and click the Deploy with Vercel or Deploy to Cloudflare button. Sign in with GitHub, confirm, get your own URL in 30 seconds. Works on any device with a browser including mobile.
Path B — Local install (works offline)
- Download the repo as a ZIP (green "Code" button → "Download ZIP") and extract it.
- On Windows double-click
OpenAdKit.bat; on Mac/Linux double-clickOpenAdKit.command. - First run installs dependencies (~2 minutes) and drops a desktop shortcut.
- From the second launch onwards it's a single double-click → browser opens to the app.
You'll know it worked when the OpenAdKit setup wizard loads in your browser.
Step 2 · 2 minutes
Pick an AI provider and paste a key
This is the only paid thing in OpenAdKit, and it can be $0 if you pick a free tier. The setup wizard shows all 9 supported providers grouped by Free (Groq, Gemini, Cerebras, OpenRouter) and Paid (Anthropic Claude, OpenAI GPT, DeepSeek, Mistral, Together AI).
Recommended for first-timers
- Groq (free, fastest) — sign up at console.groq.com, copy your API key (starts with
gsk_…), paste in OpenAdKit. - Gemini (free, great quality) — get a key at aistudio.google.com.
- Claude (best quality, paid) — get a key at console.anthropic.com, starts with
sk-ant-….
Click Verify — OpenAdKit makes one tiny test call to confirm the key works. Pick a model from the dropdown (defaults are sensible). Click Continue.
Step 3 · 3 minutes
Add your first brand
This is OpenAdKit's killer feature. You paste one URL, the AI extracts a complete brand profile in 30 seconds.
- The setup wizard's last step asks for a website URL. Paste the URL of any brand you want to generate ads for — your own brand, a client's, or a competitor's you're studying.
- Click Extract. OpenAdKit reads the homepage plus 2–3 key subpages (/about, /pricing, /services), pulls Open Graph data and JSON-LD schema, and asks the AI to fill 30+ brand fields:
- Business name, industry, niche, USP
- Tone, brand voice, words to use / avoid
- Audience: pain points, desires, demographics, service area
- Key benefits, key messages, objection handling
- Competitors, differentiators, price positioning
- VOC quotes, best-performing angles, failed angles
- Review the populated Brand Brain. Edit anything that looks off. Hit Save.
Step 4 · 1 minute
Generate your first ad
- From the dashboard (cockpit), pick a generator. For your first time, try Meta · Facebook + Instagram Ads — fast, visual, three angle-distinct variants per click.
- Fill the form:
- Objective — sales, leads, awareness
- Format — Feed / Reels / Stories / Carousel
- Product / offer — pre-filled from your Brand Brain
- Promotion — any offer like "20% off" or "free trial"
- Click Generate. Watch the AI stream the output in real time.
- You get 3 variants anchored to different psychological angles (pain, desire, social proof), each with:
- Primary text (front-loaded for Meta's 125-char mobile preview)
- Headline (≤ 27 chars mobile / ≤ 40 desktop)
- Description
- CTA button suggestion
- Character count validation per field — the schema retry layer catches AI mistakes
- For video formats: hook 0–3s, value 3–15s, CTA 5s with b-roll and on-screen text
Step 5 · 3–5 minutes
Score, optimize, and ship
You've generated copy. Now use the optimizers to make sure it's actually good.
- Copy one of your variants. Open Optimize → Creative Score from the sidebar.
- Paste the ad copy. Pick the platform you wrote it for. Click Score.
- You get:
- 5-lever score — hook strength, specificity, urgency, brand fit, conversion potential
- Tier verdict — scale / iterate / rewrite / kill
- Predicted CTR band for the platform you chose
- 3 named fixes — each fix names the exact phrase to change and the replacement
- Apply the fixes. Re-score. Repeat until your tier reads "scale" or "iterate".
- Optionally run other optimizers before launch:
- CTR Optimizer — lever-by-lever rewrites to lift click-through
- Budget Waste — audit where ad spend is leaking before it does
- Audience Targeting — turn brand brain + budget into a cold/warm/hot tier plan
- Quality Score (Google) — surface relevance issues before they tank QS
- Export the campaign as Markdown or JSON for client handoff via the History page.
What to try next
- Research → Steal & Beat — paste competitor ads from the Meta Ads Library / Google Transparency Center, get a teardown plus 3 beat-their-ad variants.
- Generate → Content Calendar — one click for a per-day social calendar with captions, hashtags, and visual briefs across multiple platforms.
- Generate → Campaign Kit — one brief becomes message-matched copy across Google + Meta + TikTok + LinkedIn + YouTube + X + email in a single generation.
- Learn → Frameworks Trainer — interactive lessons in PAS, AIDA, BAB, the 4 U's, and the Schwartz awareness ladder. Free, ad-free, no signup.
- Launch Wizard — answer 6 questions about your campaign and get a complete launch kit (copy, audience, budget, KPIs) generated in one parallel run.