Zaguán
Sign InGet Started
ZaguanBlade

Connecting ZaguanBlade

ZaguanBlade has two paths: Local AI for free local models, and Zaguán Cloud for hosted zcoderd workflows through your subscription. Cloud sign-in creates a revocable device key automatically, so you do not need to copy an API key into the app.

Use Local AI

Local AI is the free path. It uses models running on your machine through Ollama or an OpenAI-compatible local server. No Zaguán account, subscription, or API key is required.

  • •Best for private local work, experiments, and offline-friendly development.
  • •Configure it from ZaguanBlade Settings > Local AI.

Use Zaguán Cloud

Zaguán Cloud connects ZaguanBlade to hosted zcoderd and zaguancorex. It requires an active subscription because cloud AI uses hosted models, managed routing, credits, and server-side project memory.

View plansManage devices

Cloud sign-in flow

  1. 1Open ZaguanBlade and choose Sign in with Zaguán from Welcome or Settings.
  2. 2Complete sign-in in the browser with email magic link or GitHub.
  3. 3Choose a Cloud subscription if the account is not subscribed yet.
  4. 4Approve the device after subscription is active.
  5. 5Return to ZaguanBlade; the app stores the key and connects automatically.

Manual key fallback

Manual API key entry remains supported for power users and recovery. Create or revoke manual keys from Dashboard > API Keys.

Connected devices

SSO-created keys appear as connected devices in the dashboard. Revoke a device when a machine is replaced, lost, or no longer trusted.

Changing devices or keys

Multiple devices for the same account resolve to the same canonical identity, so server-side history can survive key rotation and new devices.

Troubleshooting

The browser says the code expired

Return to ZaguanBlade and start sign-in again. Device requests expire so abandoned checkout sessions cannot create stale approvals.

Checkout finished but the page is still waiting

Stripe webhooks can lag briefly. Wait on the activation page; it will re-check subscription state before approval.

Cloud chat says credits are exhausted

Open the dashboard usage or credits page from ZaguanBlade and buy more credits. Local AI remains available without a subscription.

A device should no longer have access

Open Dashboard > API Keys and revoke the device under Connected Devices. Revocation takes effect at the API gateway immediately.