Lokuma Design Agent: Overview & Getting Started

Lokuma Agent is a design intelligence layer for AI agents and developer workflows. It helps turn raw AI outputs into structured, visually refined designs—improving layout, typography, and overall clarity.

In this guide, you'll learn how to install Lokuma Agent, set up your API key, and start using it in your workflow.

1. Quick Start

Get Lokuma running in under a minute:

Install Lokuma Agent

Set your API key

Run your first prompt

Try running your first prompt in your agent:

• Make me a website for people who love skiing in the Alps, using lokuma skill
• Build a simple landing page for a coffee shop

Lokuma will help structure the layout, typography, and visual hierarchy of the generated result.

2. What Lokuma Agent does

Lokuma Agent connects your agents and local environment to Lokuma’s design intelligence—enabling your AI workflows to produce structured, high-quality designs.

With Lokuma Agent, you can:

• connect your agent to Lokuma’s design intelligence
• generate structured layouts and pages from AI output
• improve typography, hierarchy, and visual consistency automatically

Installation Details

Run the command below in your terminal:

This command:

• installs the Lokuma CLI
• connects your environment to Lokuma Agent
• enables agent tools in your development workflow

After installation, restart your AI tools (such as Claude Code, Codex, or similar environments) to ensure Lokuma Agent is properly loaded. This helps your agent recognize and use Lokuma’s design capabilities correctly.

After installation

Once installation is complete, the next step is to authenticate and connect your account. You will need:

1. a Lokuma account
2. an API key
3. available credits or billing enabled

If you have not created an API key yet, go to API Keys in the console.

3. Set up API Keys

API keys let your local environment and tools securely access Lokuma Agent.

Create an API key

1. Open the Lokuma console
2. Go to API Keys
3. Click Create API Key
4. Copy and store the key in a secure place

For security reasons, treat your API key like a password.

Best practices

• do not hardcode keys into public repositories
• use environment variables when possible
• rotate keys if you believe one has been exposed
• delete keys you no longer use

Recommended setup

Store your API key as an environment variable in your terminal configuration or project environment.

Example:

Then reload your shell or restart your terminal session.

4. Billing & Usage

Lokuma Agent uses a credit-based billing model. Your billing page helps you:

• view your current credit balance
• monitor usage
• purchase more credits
• apply promo codes when available

How billing works

Lokuma Agent usage is metered based on API and agent activity. As you use the product, credits are consumed according to your usage.

Typical usage may include:

• agent calls
• design generation or refinement tasks
• API requests made through connected tools or environments

Buying credits

Credits can be purchased in the Billing & Usage page:

• $10
• $20
• $50
• $100
• custom amount

Promo codes

If you received a promo code during a launch or campaign:

1. go to Billing & Usage
2. enter the code in the promo code field
3. apply the code before checkout (if supported)

Usage visibility

On the billing page, users should be able to see:

• total credits remaining
• recent usage
• purchase history or top-ups
• current billing status

5. Agent Setup

Lokuma Agent can be used within supported AI development environments.

Refer to integration guides for setup instructions with tools like Cursor, Claude Code, or similar workflows.

6. Troubleshooting

Install command does not run

Check the following:

• your terminal has permission to run shell scripts
• your network connection is stable
• your environment supports the required dependencies

Try running the install command again:

CLI installed but agent does not connect

Possible reasons:

• API key is missing or invalid
• billing is not enabled or credits are unavailable
• environment variables were not loaded correctly
• local environment configuration is incomplete

API key issues

If authentication fails:

• confirm the key is copied correctly
• check whether the key has been revoked
• generate a new key if needed

Billing or usage looks incorrect

Go to Billing & Usage to check:

• your remaining credits
• recent usage records
• any recent purchases or promo code applications

If something still looks off, contact support.

7. FAQ

1. Do I need an API key to use Lokuma Agent?

   • Yes. In most agent and API-based workflows, an API key is required to authenticate your environment.

2. Do I need credits before I start?

   • Yes. Lokuma Agent uses a usage-based credit model, so an active credit balance is required.

3. Can I use Lokuma Agent with my existing AI tools?

   • Yes. Lokuma Agent is designed to work alongside AI-native development workflows.

4. Is Lokuma Agent the same as Website Builder?

   • No. Lokuma Agent is the developer- and agent-facing product experience for bringing Lokuma’s design intelligence into external workflows.
   • Lokuma Website Builder is a separate product area inside Lokuma.

8. Support

If you run into issues with installation, billing, or API access, contact the Lokuma team through the support channel listed in the console or on the website.

Email: support@lokuma.ai

Recommended support topics:

• installation issues
• billing questions
• API key problems
• credits and usage clarification
• integration troubleshooting