Skip to main content

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)

  1. Download the repo as a ZIP (green "Code" button → "Download ZIP") and extract it.
  2. On Windows double-click OpenAdKit.bat; on Mac/Linux double-click OpenAdKit.command.
  3. First run installs dependencies (~2 minutes) and drops a desktop shortcut.
  4. 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

Click Verify — OpenAdKit makes one tiny test call to confirm the key works. Pick a model from the dropdown (defaults are sensible). Click Continue.

You can add multiple provider keys and switch between them anytime in Settings — useful when you hit a free-tier rate limit. One-click swap to another provider.

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.

  1. 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.
  2. 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
  3. Review the populated Brand Brain. Edit anything that looks off. Hit Save.
For agencies: repeat Step 3 for each client. Switch the "active client" from the top-bar dropdown anytime; every generator and optimizer automatically uses the active client's Brand Brain to keep voice consistent.

Step 4 · 1 minute

Generate your first ad

  1. From the dashboard (cockpit), pick a generator. For your first time, try Meta · Facebook + Instagram Ads — fast, visual, three angle-distinct variants per click.
  2. 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"
  3. Click Generate. Watch the AI stream the output in real time.
  4. 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
Hit ⌘+↵ (Mac) or Ctrl+↵ (Windows) anywhere in the generator to regenerate without touching the mouse.

Step 5 · 3–5 minutes

Score, optimize, and ship

You've generated copy. Now use the optimizers to make sure it's actually good.

  1. Copy one of your variants. Open Optimize → Creative Score from the sidebar.
  2. Paste the ad copy. Pick the platform you wrote it for. Click Score.
  3. 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
  4. Apply the fixes. Re-score. Repeat until your tier reads "scale" or "iterate".
  5. 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
  6. Export the campaign as Markdown or JSON for client handoff via the History page.
Use Launch Guide in the sidebar for step-by-step screenshots walking you through Facebook Ads Manager or Google Ads from campaign creation to publish — useful if you're new to paid media.

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.
Model—
Spend$0.0000
In0
Out0
--:--:--