Register & set up VidFarm

Step 1 — create your accountRegister (it's the login screen)

First surprise: there is no separate register page. Registration happens on /login → through the email one-time-code flow — a first-time email that verifies a code becomes a new account. If you type /register, head to /login instead.

1. 1

   Open the login screen

   Go to /login →. The default mode is "Email code" (there's also a "Password" segment for later). The left panel is marketing — "A week of content, made in an afternoon." — and the right panel is the auth card.

   Open /login →
2. 2

   Request your login code

   Enter your Email and click "✉ Email me a login code". The card switches to "Check your email."

3. 3

   Enter the code and your name

   Type the 6-digit code, then fill in "Your name (optional — for new accounts)" — this is the registration signal for a first-time email. Click "Verify & continue →". You're registered, signed in, and dropped on /settings.

Step 2 — Developer tabCopy your VidFarm API key

Everything an agent needs to authenticate is one key. It lives on the Developer tab — the same tab that holds your AI keys and the agent skill, so you'll do the next three steps without leaving this page.

1. 1

   Go to Settings → Developer

   Open Settings → Developer →. Settings has a left nav — Profile · Wallet · Channels · Developer, plus a separate Subscription link and a Log out.

   Open Settings → Developer →
2. 2

   Reveal and copy the key

   In the "Your vidfarm API key" card, click the eye to reveal the key (optional), then click "Copy" — it flashes "Copied!". The field is read-only; you can only reveal and copy it.

3. 3

   Store it for the CLI or REST

   Save it as VIDFARM_API_KEY for the vidfarm CLI, or send it as the vidfarm-api-key HTTP header for REST calls — never Authorization: Bearer.

Step 3 — BYOKAdd your own AI keys

Bring-your-own-key (BYOK) turns on the smart features and keeps costs near zero, because your keys are never billed by VidFarm. Same Developer tab, second card.

1. 1

   Open "Bring your own AI Keys"

   On the same Developer tab →, scroll to "Bring your own AI Keys" and click the gold "Add AI Key" button.

2. 2

   Pick a provider and paste the key

   Choose a Provider — OpenAI, Gemini, or OpenRouter for full features; Nvidia (clipping only) or ElevenLabs (audio only) for the limited ones — add an optional Label, paste the API key, and click "Add AI key".

   Start with OpenAI or Gemini for the core features; the Nvidia and OpenRouter partnered free tiers keep costs near zero. Remember: Nvidia can't generate images or video, and ElevenLabs isn't a qualified AI key — always pair them with a full key.

Step 4 — teach an AI to drive VidFarmInstall the agent skill

The last core step turns any capable coding agent into a VidFarm director. The skill is vidfarm, and it installs from GitHub with one command.

1. 1

   Open the install command

   On the Developer tab →, find the SKILL.md pill (below the API key). Click the ⋮ menu to open the "Install Command" popover and copy npx skills add https://github.com/officexapp/vidfarm. There's a "View GitHub" link there too.

2. 2

   Install it into your agent

   Run that command in the project where your AI coding agent (Claude Code, Codex, etc.) lives. It pulls the vidfarm skill from GitHub so the agent gains VidFarm's operating knowledge — the three paintbrushes and the full REST/CLI playbook.

3. 3

   Or copy the whole playbook

   No CLI handy? Click the SKILL.md pill itself to copy the entire playbook to your clipboard, then paste it into your agent's context. Finally, make sure VIDFARM_API_KEY (Step 2) is set so the agent can authenticate.

Step 5 — finish the profileOptional — channels & product profile

Two optional steps make VidFarm work harder for you once the essentials are done:

• Connect a publishing channel. Settings → Channels tab → "Connect" (a FlockPoster API-key dialog), or the ⋮ → "Add Email Channel". This is what a Schedule action publishes to.
• Set your product description. Settings → Profile tab → the "Product description" textarea ("What it is, who it's for, the promise…"). Its hint: "Swipe mode reads this to auto-recut templates into ads for you" — so filling it in powers Swipe's auto-recut.

For devcli usersDo the whole setup from the terminal

Prefer the command line? This block runs the entire setup — install the skill, register via OTP, save the key, add a BYOK key, and confirm auth:

npx skills add https://github.com/officexapp/vidfarm   # install the agent skill
vidfarm login you@studio.co                                     # request an OTP
vidfarm verify you@studio.co 123456                             # verify → prints your API key
export VIDFARM_API_KEY=<key>                                    # save it
vidfarm whoami                                                  # confirm auth works
vidfarm add-provider-key openai sk-...                          # bring your own key
vidfarm provider-keys                                           # list keys to confirm

Where to go next

You're set up. Now make something — start with the fastest end-to-end path, or the gentlest first edit: