If you run a business on Gerany — classes, bookings, a shop, memberships, a venue — it can work alongside the tools you already use instead of making you copy everything over by hand.
One command does everything. It installs the Gerany command line, connects the AI assistants already on your machine, signs you in through the browser, and checks the result:
- macOS / Linux: curl -fsSL https://gerany.com/install.sh | sh
- Windows: irm https://gerany.com/install.ps1 | iex
Then just ask your assistant: "add a $25 hoodie and publish it", "open Saturdays 9 to 1", or "what sold this week?". Keep the command line current with gerany update.
No code needed for your calendar either. If your scheduling tool can publish a public calendar link (ICS) — Google Calendar, Apple Calendar and most booking software can — paste it under Settings → Connected calendars. Your upcoming classes become experiences automatically and refresh every hour.
What your assistant can do. It manages your storefront and your experiences — the profile, the team, the schedule, the catalog and stock, orders and shipping, memberships, your customers and the shared inbox — and can refund a sale back to a buyer. It can never read your messages, move money out of your payout account, or reach your personal wallet or moderation; those stay app-only.
Buying needs your approval. If you allow it, the assistant can also buy — but only after it asks you, in the client, to approve the exact item and amount. A purchase never charges a card on its own: it creates a secure checkout link for you to open and pay.
Want the key and the endpoints instead? In Settings → API keys you can create a key bound to your storefront, shown once. The full technical reference — every endpoint, example requests, and what each error means — is at gerany.com/integration-api.md, written to be handed to an AI coding assistant.
Stuck? Write to [email protected] and tell us what you're trying to connect.
01
Connect a calendar — no code needed
1. In your scheduling tool (Google Calendar, Apple Calendar, most booking software), copy the public ICS link.
2. In Gerany: Settings → Connected calendars → paste the link.
3. Choose a default venue for imported events.
4. Done — upcoming events become experiences automatically and refresh hourly.
02
Create an API key
1. You usually do not need one: run the installer above and it signs you in through the browser, with no key to copy.
2. If you do want a key — for your own website or system — open Settings → API keys and create one.
3. Choose the storefront to bind it to, and keep the recommended scopes — they are exactly what your role on that storefront allows.
4. The key is shown once — copy it into a password manager immediately. Revocation is instant.
5. The key manages that storefront and your experiences: profile, team, schedule, catalog, orders, memberships, customers and the inbox, plus tickets and door check-in. It can refund a sale, but never reads your messages, moves money out of your payout account, or touches your personal wallet or moderation.
03
Build with the API
1. The Gerany command line is also a Model Context Protocol server, so an AI assistant can run your storefront directly. One command installs it, connects the assistants it finds, signs you in and checks it:
- macOS / Linux: curl -fsSL https://gerany.com/install.sh | sh - Windows: irm https://gerany.com/install.ps1 | iex
2. Keep it current with gerany update.
3. The full technical reference lives at gerany.com/integration-api.md — every endpoint, example requests, and every error explained.
4. It's written to be handed to an AI coding assistant: point one at that page and it can build your integration for you. Ready-made instructions cover syncing your schedule, embedding your experiences on your own website, and building a door check-in screen.