Help Center
We've got
We've got
answers.
Real answers about API keys, self-hosting, and getting your listings out the door.
Still stuck?
Can't find your answer below? Email us directly - a real person reads every message.
Frequently Asked Questions
How do I get a Gemini API key?
HawkHero uses Google's Gemini API to generate listings, and you bring your own key. Go to Google AI Studio (aistudio.google.com), sign in with a Google account, and create a free API key. Paste that key into your HawkHero server's configuration - not into the app itself.
How do I set up a server?
HawkHero is BYOS - bring your own server. The app talks to a small backend that you run. At a high level: get the HawkHero server running somewhere you control (a home computer, a NAS, or a cheap VPS), start it with
uvicorn hawkhero:app, add your Gemini API key to its config, then point the HawkHero app at your server's address in Settings. Full setup docs ship with the server package.What platforms are supported?
HawkHero formats every generated listing for eBay, Facebook Marketplace, Mercari, and Poshmark - matching each platform's title limits, tag style, and category conventions.
How do I export a listing?
Open the listing from your History, pick the marketplace tab (eBay, Facebook Marketplace, Mercari, or Poshmark), and tap "Copy for [platform]." The formatted title, description, price, and tags are copied to your clipboard, ready to paste into that marketplace's app or site.
Where's the dark/light mode toggle?
Tap the sun/moon icon in the top corner of the app to switch themes instantly. HawkHero also follows your device's system theme automatically until you choose one manually.
Where is my data stored?
Locally on your device, and on the server you host yourself. HawkHero and MACCAM LLC don't operate servers that store user photos or listings - see our Privacy Policy for details.