Billing — Plans and Usage¶

Gremia uses a simple, unit-based billing model. Instead of counting tokens, you pay for the outcomes you care about: manifests (business configurations generated by the Builder) and agent tasks (discrete actions executed by your AI team in the Shell). No token math, no surprise bills.

Plans¶

Feature	Free	Pro	Enterprise
Monthly price	$0	$49/mo ($39/mo annual)	$249/mo ($199/mo annual)
Manifests/month	3	25	100
Agent tasks/month	50	500	2,000
Model access	Fast only	Fast + Balanced	Fast + Balanced + Powerful
Team members	1	10	Unlimited
Support	Community	Email (24h)	Dedicated
SLA	None	99.5%	99.9%
Audit retention	30 days	365 days	Custom (up to 10 years)
Free trial	—	14 days	30 days (upon demo)
Overage	—	$1/manifest, $0.15/task	$1/manifest, $0.15/task

Free Plan¶

The Free plan is designed for evaluation and small personal projects:

3 manifests per month to explore the Builder
50 agent tasks per month to run basic automations in the Shell
Access to the Fast model tier
No credit card required

Once you exhaust your monthly allowance, limits reset at the start of your next billing period.

Pro Plan¶

For individuals and small teams that rely on Gremia daily:

25 manifests per month for ongoing business configuration
500 agent tasks per month for automations
Access to Fast and Balanced model tiers
Up to 10 team members
Email support with a 24-hour response time
99.5% uptime SLA and 365-day audit retention
14-day free trial — no credit card required upfront

At $49/month (or $39/month billed annually at $468/year), the Pro plan renews automatically via Stripe. Need more? Overages are billed at $1 per extra manifest and $0.15 per extra task.

Enterprise Plan¶

For organizations with high-volume, compliance, or customization requirements:

100 manifests and 2,000 agent tasks per month
Access to all model tiers including Powerful
Unlimited team members
Dedicated account manager and custom SLA (99.9%)
Custom audit log retention (up to 10 years)
On-premise deployment options
SSO/SAML integration

At $249/month (or $199/month billed annually at $2,388/year). Overages at $1/manifest and $0.15/task. Contact sales@gremia.io for custom requirements.

What Counts as a Manifest¶

A manifest is the team_manifest.json file that defines your AI team — the agents, their tools, their roles, and how they collaborate.

Every time the Builder successfully generates a new manifest from a business description, it counts as 1 manifest against your monthly allowance.
Refinements do not count. If you iterate on an existing manifest (e.g., adding an agent, adjusting tool permissions, renaming a role), that refinement does not consume an additional manifest slot. Only the initial generation of a manifest is billable.
Cloning or renaming an existing manifest does not count as a new manifest.

Action	Counts as manifest?
Generate new manifest from a business description	Yes
Refine or iterate on an existing manifest	No
Clone an existing manifest	No
Download or export a manifest	No

What Counts as an Agent Task¶

An agent task is a complete, discrete unit of work executed by an agent running in the Gremia Shell.

When a user or scheduler triggers an agent to perform a job (e.g., "generate report", "send email", "analyze customer data"), that counts as 1 agent task regardless of how many internal steps the agent takes to complete it.
A task may involve multiple model calls, tool invocations, and sub-steps internally — the billing unit is the task outcome, not the number of steps.
Failed tasks do not count. If a task errors out before completing, it is not billed.

Action	Counts as agent task?
Agent completes a triggered job successfully	Yes
Agent fails before completing	No
Internal sub-steps within a single task	No
Scheduled task that runs successfully	Yes
Manual task triggered from the Shell UI	Yes

Model Tiers Explained¶

Gremia manages model selection internally. You do not choose a specific model — instead, your plan determines which performance tiers are available for your agents:

Tier	Characteristics	Available on
Fast	Lowest latency, most cost-efficient. Best for simple, high-volume tasks.	All plans
Balanced	Best quality-to-speed ratio. Suitable for most business workflows.	Pro + Enterprise
Powerful	Highest reasoning capability. Best for complex analysis and generation.	Enterprise only

The manifest specifies which tier each agent uses. Agents on higher tiers produce better results for demanding tasks, while Fast-tier agents handle routine work efficiently.

Checking Your Usage¶

Via the Web Dashboard¶

Navigate to Settings > Billing to see:

Your current plan tier
Manifests used vs. your monthly allowance
Agent tasks used vs. your monthly allowance
Billing period start and end dates
Daily task activity chart (last 30 days)

Via the API¶

# Get current plan and limits
curl https://api.gremia.io/api/v1/billing/plan \
  -H "Authorization: Bearer $TOKEN"

{
  "plan": "pro",
  "period_start": "2026-02-01T00:00:00Z",
  "period_end": "2026-03-01T00:00:00Z",
  "manifests": { "used": 4, "limit": 25 },
  "agent_tasks": { "used": 83, "limit": 500 }
}

# Get daily usage history (last 30 days)
curl "https://api.gremia.io/api/v1/billing/usage?days=30" \
  -H "Authorization: Bearer $TOKEN"

{
  "days": [
    {
      "date": "2026-02-20",
      "manifests": 1,
      "agent_tasks": 12
    }
  ]
}

Managing Your Subscription¶

Upgrading¶

Go to Settings > Billing > Upgrade
Select the Pro or Enterprise plan
Complete checkout via Stripe
Your new limits take effect immediately

Via the API:

curl -X POST https://api.gremia.io/api/v1/billing/checkout \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "plan": "pro",
    "success_url": "https://app.gremia.io/billing/success",
    "cancel_url": "https://app.gremia.io/billing/cancel"
  }'

Managing Payment Methods¶

Access the Stripe Customer Portal to:

Update your payment method
View invoices and payment history
Cancel your subscription

curl -X POST https://api.gremia.io/api/v1/billing/portal \
  -H "Authorization: Bearer $TOKEN"

The response contains a portal_url that redirects to Stripe's hosted portal.

Downgrading¶

Downgrading takes effect at the end of your current billing period. Until then, you retain access to your current plan's limits and features. No partial refunds are issued.

Limit Exhaustion¶

When you reach your monthly limit, Gremia applies the following behavior:

Manifest limit reached¶

The Builder remains available for refinements on existing manifests
New manifest generation is paused until your limit resets or you upgrade
A warning banner appears in the web dashboard and Builder interface

Agent task limit reached¶

Currently running tasks complete normally — no task is interrupted mid-execution
New tasks cannot be started until your limit resets or you upgrade
The Shell displays a notification and queues scheduled tasks for the next period
You can still view past execution history and audit logs

Both limits reset automatically at the start of each billing period. To unblock immediately, upgrade your plan from Settings > Billing.

Webhooks¶

Gremia processes Stripe webhook events to keep billing state synchronized:

checkout.session.completed — Activates the new plan and applies updated limits immediately
invoice.paid — Resets monthly manifest and agent task counters for the new billing period
customer.subscription.deleted — Downgrades the account to the Free plan at period end

These events are handled automatically. No configuration is required on your end.