xobytes.com

Page

How to Install Agentic Token Engine

How to install Agentic Token Engine is easy when you follow the correct setup steps. Agentic Token Engine by Xobytes is a WordPress AI token system that helps you add token-based AI usage to plugins, themes, SaaS tools, dashboards, and agentic software.

With this plugin, you can connect AI providers, create AI action keys, set token costs, manage user balances, set usage limits, sell WooCommerce token packs, and display modern token cards inside WordPress admin areas.

If you have not purchased the plugin yet, you can visit the Xobytes software shop.

What You Need Before Installation

Before you install Agentic Token Engine, make sure you have everything ready. This will help you finish the setup faster and avoid common issues.

You Will Need:

  • The Agentic Token Engine plugin ZIP file
  • A valid Xobytes license key
  • Administrator access to your WordPress website
  • An AI provider API key, such as OpenAI, Anthropic, Gemini, or OpenRouter
  • WooCommerce installed if you want to sell token packs

You can install the plugin without WooCommerce. However, you will need WooCommerce if you want customers to buy token packs from your store.

Step 1: Log In to WordPress

First, log in to your WordPress admin dashboard. You need an administrator account because only admins can upload, install, and activate plugins.

After you log in, go to your main WordPress dashboard.

Step 2: Upload the Plugin ZIP File

Next, go to:

Plugins > Add New Plugin > Upload Plugin

Then, click Choose File and select the Agentic Token Engine ZIP file from your computer.

After that, click Install Now. WordPress will upload the ZIP file and install the plugin.

Step 3: Activate Agentic Token Engine

Once WordPress finishes installing the plugin, click Activate Plugin.

After activation, you should see a new admin menu called:

AI Tokens

This is where you manage your license, provider keys, token balances, action costs, WooCommerce token packs, and usage settings.

Step 4: Activate Your Xobytes License

Next, activate your license. This step confirms that your copy of Agentic Token Engine is valid and connected to your site.

Go to:

Ai Tokens > License

Paste your Xobytes license key into the license field. Then, click the activation button.

If your license is valid, Agentic Token Engine will activate the site and save the license status. If the license does not activate, check the key and make sure your website can connect to the Xobytes license server.

Step 5: Add Your AI Provider Keys

After your license is active, add your AI provider keys.

Go to:

AI Tokens > Settings

Agentic Token Engine can support provider settings for OpenAI, Anthropic, Google Gemini, and OpenRouter. Add the provider keys you want to use, then save your settings.

For better security, do not place API keys in public JavaScript, page content, frontend templates, or code snippets. Agentic Token Engine stores provider keys server-side so AI requests can run safely from WordPress.

Step 6: Choose a Default Provider and Model

Next, choose your default AI provider and model.

The default provider and model are used when an AI action does not have its own custom provider or model. This keeps your setup simple while still giving you control.

For example, you may use one model for simple writing tasks and another model for longer or more advanced AI actions.

Step 7: Set Starting Token Balance

Now choose the starting token balance for users. This setting lets you give new users a set number of tokens when they begin using your AI tools.

For example, you may give new users 100 free tokens, 500 free tokens, or no free tokens at all.

This depends on your business model. If you want users to try the AI tools before buying more tokens, a small starting balance can help.

Step 8: Set Daily and Monthly Usage Limits

AI usage can become expensive if you do not control it. Because of that, Agentic Token Engine includes daily and monthly usage limits.

Go to:

AI Tokens > Settings

Then, set your daily and monthly token limits.

These limits help protect your site from abuse, mistakes, and unexpected AI usage spikes.

Step 9: Choose Allowed User Roles

Next, choose which WordPress user roles can use AI actions. This gives you more control over who can spend tokens.

For example, you may allow:

  • Administrators
  • Editors
  • Customers
  • Members
  • Custom user roles from another plugin

This is useful for membership sites, SaaS dashboards, client portals, and private AI tools.

Step 10: Create Your First AI Action

Now it is time to create your first AI action.

Go to:

AI Tokens > Actions & Costs

An AI action is a task that your software can run. Each action uses an action key. The action key tells Agentic Token Engine which AI task is running and how many tokens it should cost.

Example Action Keys:

  • generate_blog_post
  • write_product_description
  • create_seo_meta
  • summarize_message
  • generate_support_reply

For each action, you can set the action label, token cost, provider, model, button text, and system prompt.

Step 11: Set Token Costs Per Action

Each action can have its own token cost. This helps you charge more for larger AI tasks and less for smaller tasks.

Example Token Costs:

  • Generate blog post — 50 tokens
  • Create SEO title and meta description — 15 tokens
  • Write product description — 35 tokens
  • Generate support reply — 20 tokens
  • Create documentation page — 75 tokens

As a result, your AI system becomes easier to manage and monetize.

Step 12: Connect WooCommerce Token Packs

If you want to sell tokens, connect Agentic Token Engine to WooCommerce products.

Go to:

AI Tokens > WooCommerce Packs

From there, you can connect token amounts to WooCommerce products. When a user buys a token pack, Agentic Token Engine can add those tokens to their account.

Example Token Packs:

  • Starter Pack — 10,000 tokens
  • Pro Pack — 50,000 tokens
  • Business Pack — 200,000 tokens

This gives you a simple way to monetize AI usage on your WordPress site.

Step 13: Review the Dashboard

After setup, go to:

AI Tokens > Dashboard

The dashboard shows your token system overview. You can review license status, provider settings, token balances, user activity, and usage history.

This gives you one place to monitor your AI token system.

Step 14: Test Your First AI Action

Before you launch your AI tools, test your first action. This helps you confirm that the provider key, model, token cost, user balance, and prompt all work correctly.

If the action fails, check your provider key, license status, user role permissions, and token balance.

Step 15: Add Token Cards to Your Admin Pages

Agentic Token Engine includes modern token cards that you can add to other admin pages. These cards can show token balances and AI action buttons inside your own plugin or theme dashboard.

Example Token Card Code:

echo xobytes_ai_render_token_card( array(
    'title'   => 'AI Tokens',
    'user_id' => get_current_user_id(),
) );

This is useful when you build agentic themes, AI plugins, SaaS dashboards, and custom admin tools.

Step 16: Add AI Action Buttons

You can also add AI action buttons to your own software. These buttons let users run AI tasks from your admin screens.

Example AI Button Code:

echo xobytes_ai_render_action_button( array(
    'action_key'  => 'generate_blog_post',
    'prompt'      => 'Write a blog post about roof repair.',
    'button_text' => 'Generate With AI',
) );

When the user clicks the button, Agentic Token Engine can check their balance, charge the correct token cost, and run the AI request.

Common Installation Problems

The Plugin Does Not Upload

If WordPress does not upload the ZIP file, check your website’s maximum upload size. If the ZIP file is larger than your upload limit, increase the upload limit or upload the plugin through your hosting file manager.

The License Does Not Activate

If your license does not activate, make sure you copied the full license key. Also, confirm that your site can connect to the Xobytes license server.

The AI Provider Key Does Not Work

If an AI provider key does not work, check that the key is active and copied correctly. Also, make sure your provider account has billing enabled if required.

Users Cannot Run AI Actions

If users cannot run AI actions, check their token balance, user role, daily limit, monthly limit, and action cost.

WooCommerce Token Packs Do Not Add Tokens

If token packs do not add tokens after purchase, confirm that WooCommerce is active and that the token pack product is connected inside the WooCommerce Packs page.

Best Practices After Installation

Start with a few simple AI actions. Then, test each one before adding more. This helps you confirm that token costs, prompts, models, and usage limits work as expected.

Also, review the token ledger often. The ledger helps you understand how users spend tokens and which AI actions they use most.

Finally, keep provider keys private. Never place API keys inside public code, browser JavaScript, frontend pages, or screenshots.

Final Thoughts

Now you know how to install Agentic Token Engine on your WordPress site. First, upload and activate the plugin. Then, activate your license, add provider keys, create AI actions, set token costs, and connect WooCommerce token packs.

After setup, you can use Agentic Token Engine as the token foundation for agentic themes, AI plugins, SaaS tools, client dashboards, and smart WordPress software.

To get started, visit the Xobytes software shop.

Hey, I’m Xoie. Let me know if you need help.