Go Home
Platform Documentation

General Documentation

What Memescale is, the infrastructure beneath it, the plans, and the account essentials. Start here to understand the platform before deploying a bot.

Open in Claude Desktop App
Module

Start Here

Read this before anything else. The one chapter that covers what every Memescale bot can do and how to use it.

Everything You Need To Know

Read this before anything else, what every Memescale bot can do, and how to use it

Bot Plans & Image Editing

Overview

Memescale offers two types of bots. Free bots and commercial meme bots. Both support image editing with reference image support, the difference is character training and generation limits.

Bot types & editing
Free Bots
  • Everyday Telegram groups
  • Up to 100 free edits / day
  • Image editing + moderation
Commercial Meme Bots
  • Crypto & meme communities
  • Unlimited generation
  • Trained on your character
Up to 3 reference images
/Edit caption
Edited image

At Memescale we offer two different types of bots: free bots and commercial meme bots. Free bots, along with commercial meme bots, offer image editing with reference image support. Free bots are best for everyday Telegram groups that need AI image editing, simple group moderation, commands for automated bot responses, or for anyone that wants to explore Memescale's custom dashboard without the need for any payment at all.

Commercial meme bots are best for crypto communities, meme coins, NFT communities, cartoon studios and creators, and anyone that needs unmeasured inference of a specific character on-demand without the variation or per-image fee that may be present in leading AI lab models.

Generation Limits

Free bots have generous limits of up to 100 free edits per day. Commercial meme bots have unlimited image generation. "Unlimited" means uninterrupted image generation that does not have any cap or cooldown, or tally on the amount of images generated. This means that the price of your commercial Telegram bot, regardless of the plan, will not differ in price if you generate 1,000 images in a month, or 100,000 images in a month.

Image Editing

Image editing as a feature can be used to edit images you provide the model with, or images that the model generates on its own. Reference image support means that you can upload up to three images with a caption that describes the edit you'd like and begins with /Edit. Unless deliberately clarified with clear instruction, the model will automatically determine which image to use as the base image.

For example, if you send three images into a group as a normal message, not as a response to another image in the group, featuring a character, a white hat, and black glasses, you'll need to clarify which image you want as the base image to generate the best results.

text
Good:  /Edit add the white hat and black glasses on to the character
Vague: /Edit merge these images
Be Specific

While the vague example may still generate an image that aligns with the original intention, there is no upsampling or prompt enhancement that occurs at inference, so being as specific as possible ensures your image comes out as expected. Tell the model which image is the base and what to apply from the others.

Group Moderation

Overview

Both free bots and commercial meme bots offer group moderation. Moderation is off by default. You need to intentionally activate it inside the dashboard.

Moderation flow
Offending message
/ban or /mute
Auto-cleanup
Tidy chat
/ban
  • Reply to message, or tag @user
  • Permanent block
/mute
  • 24-hour mute
  • Needs mute permission

Both free bots and commercial meme bots offer group moderation that is off by default. This means you need to intentionally activate moderation inside of the dashboard for any of this to be active. Group moderation offers muting and banning, with /mute and /ban as the only two commands.

How /ban Works

The ban functionality, triggered by /ban, automatically bans either (1) the user the message was sent in response to, or (2) the user you tag in a message such as /ban @User. This means that if a malicious user sends a message and you respond directly to that message with /ban, the user will be banned. The second option, banning by tagging the user, is best for any verifiable malicious user that is known by username.

How /mute Works

The muting functionality is a 24 hour mute, and requires the bot to have explicit permissions to mute users in the group. Without explicit permissions through the settings of the group, the request will silently fail. Both /mute and /ban can be triggered by any admin inside of the group, and are best only for Telegram groups where all admins are trusted with such responsibilities.

Any Admin Can Trigger Moderation

There is no per-admin permission layer, every group admin can issue /mute and /ban once moderation is enabled. Only enable moderation in groups where you trust every admin.

Why Moderation Exists Here

The only reason moderation exists on these AI bots is due to internal requests made because many Telegram moderation bots leave the chat a mess, with the formerly banned user's message still present, bot messages stating users have been banned, and additional messages that require additional admin cleanup.

Auto-Cleanup Is Always On

Both free bots and commercial meme bots' group moderation features auto-cleanup that is on by default and cannot be turned off. While moderation itself is off by default, the logic behind the moderation is fixed, when you /ban or /mute someone, the offending message and the moderation command itself are cleaned up automatically.

Custom Commands & Buttons

Overview

Both bot types offer command customization, known as filters. Triggers like /ca or /socials send an automated response, optionally with up to twelve colored inline buttons.

Filter anatomy
/ca /socials trigger
Static text reply
Up to 12 buttons
Default
Primary
Success
Danger

Both of these bots, free bots and commercial meme bots, offer command customization, known as filters. In the dashboard, filters can be added with colored buttons that can either be inline (all buttons on one row) or stacked (each button on its own row). Phrases such as /ca or /socials can trigger automated bot responses.

Memescale bots support commands with customizability buttons to supplement static text that is normally sent in response to filter triggers. This means you can create commands with up to twelve buttons per command that are included in the message your bot responds with.

Trigger Matching

Triggers are matched with or without a leading slash, and matching is case-insensitive. "/ca", "ca", and "/CA" all fire the same command. Triggers themselves are alphanumeric plus underscores: no spaces, no symbols.

Button Layout

Each command can have between one and twelve buttons. When you build a command in the dashboard, you choose one of two layouts:

InlineAll buttons sit side-by-side on a single row. Best for short labels (e.g. "Chart", "Buy", "Site").
StackedEach button gets its own row, listed vertically. Best for longer labels or when you want each option to read like a distinct call-to-action.

Button Colors

Memescale bots support Telegram's colored inline buttons. Each button can be set to one of four colors:

Default (gray)Standard Telegram button, neutral, blends in with the chat.
Primary (blue)Draws attention without being alarming. Good for primary links like a website or chart.
Success (green)Signals a positive action. Good for buy links, join links, or anything that feels like a "go."
Danger (red)Strong visual emphasis. Use sparingly, for warnings or things you want users to notice immediately.

What a Button Holds

Each button has two fields you fill out: a label (the text shown on the button, up to 64 characters) and a URL (where the user is taken when they tap it). URLs must be valid web links, bare domains like memescale.ai are automatically upgraded to https://memescale.ai when you save.

Filters Are Live Instantly

When you add, edit, toggle, or delete a command in the dashboard, the change is pushed to your bot immediately. No restart, no waiting. The next time someone types your trigger in the group, the new response fires.

Module

The Platform

What a Memescale bot is, why teams pick it, and the isolated, secure infrastructure every bot runs on.

Platform Overview

What Memescale is and why it works

What Memescale Is

Overview

Memescale builds custom-trained AI image generation bots for Telegram and X. You give us images of your character, we train a model, and you get a bot that generates that character on demand — with no credit system and no per-image cost.

What you get
Your character images
Trained model
Live bot
Gallery website

Memescale is a platform for deploying AI image bots tied to a specific character. The character is yours — a mascot, a token persona, a brand figure — and we train a model so the bot can draw it in any scene a user describes.

Two things make this different from generic AI image tools. First, the bot only knows your character, so every result is on-brand. Second, there are no credits and no metering: once a bot is live, your community generates as much as they want for a flat monthly price.

What you get
A trained modelFine-tuned on your character images
A live botTelegram and/or X, ready to use
A gallery websiteFree site at {character}.memescale.ai
Unlimited generationsNo credits, no per-image charge
Flat pricing

You pay one monthly fee for the plan. Generation volume never changes the bill.

Why Teams Choose Memescale

Overview

Memescale removes the friction that slows other AI tools down: pricing is flat and visible up front, deployment is same-day, and there is nothing to meter or top up.

Friction removed
Elsewhere
  • Per-image credits run out
  • Generic off-brand models
  • Slow onboarding
  • Hidden costs
Memescale
  • Flat price, unlimited use
  • Model trained on your character
  • Same-day deployment
  • Plan price is the whole price
Friction elsewhereHow Memescale handles it
Per-image credits that run outFlat monthly price, unlimited generations
Generic models that miss your brandA model trained only on your character
Slow onboardingPay, upload images, bot is live the same day
Hidden costsPlan price is the whole price
  • No credit system — community members generate freely.
  • Same-day deployment once images are uploaded.
  • A free gallery website provisioned automatically per character.
  • All bot settings are editable live from the dashboard.

Infrastructure & Security

Overview

Every Memescale bot runs on an isolated GPU server. All ports are closed except a cryptographically protected SSH tunnel, the servers are DDoS-resistant, and Telegram bots make no external API calls at all.

Isolation model
Protected SSH tunnel
All other ports closed · DDoS-resistant
Isolated GPU process
One bot — no shared surface
Telegram only
Zero outbound API calls

Your bot does not share a process with anyone else's. It runs as an isolated GPU process with no external dependencies, which means one community's traffic can never affect another's.

  • Isolated GPU processes — one bot's load never touches another's.
  • All server ports closed except a protected SSH tunnel.
  • DDoS-resistant by design — the generation endpoint is not publicly reachable.
  • Telegram bots make zero outbound API calls; they only talk to Telegram and the GPU.
X agents are the exception

X (Twitter) agents do use the X API because posting to X requires it. Telegram bots do not.

Why isolation matters

Because each bot is sandboxed, a spike in one community has no effect on yours, and there is no shared surface for an attacker to exploit. The trade-off is cost — full isolation is why dedicated compute is priced above shared compute.

Bots & Channels

Compute, identity, and X agents

Choosing Your Compute

Overview

Memescale offers two kinds of compute: shared and dedicated. Shared is cheaper and good for testing and smaller communities; dedicated is faster and unthrottled. Start on shared, move to dedicated when engagement justifies it.

Shared vs dedicated
Shared
  • 1 GPU across 4 projects
  • Under 15s — 30s at peak
  • Best for testing
Dedicated
  • 100% of the GPU
  • 5-8s per image, no throttle
  • Best for active communities

Compute is the GPU power behind your bot. The plan you pick decides how that GPU is allocated.

Shared computeDedicated compute
GPU allocationOne GPU across up to 4 projects100% of the GPU, no sharing
SpeedUsually under 15s, up to 30s at peak5-8s per image
ThrottlingRound-robin queue at peakNone
Best forTesting and smaller groupsActive communities and X agents

When to upgrade

Begin on shared compute. It is the cheapest way to confirm the model looks right and your community engages. When the queue starts making generations feel slow — or when you add X or multiple characters — move to dedicated.

No model loss on upgrade

Changing compute plans keeps your trained model exactly as it is. Only speed and allocation change.

Bot Identity & Profile

Overview

Your bot's username, profile picture, and bio are all yours to set. Telegram profile changes apply instantly from the dashboard; X profile changes are handled manually to avoid shadow bans.

A Memescale bot is a real Telegram or X account with its own identity. You control how it presents itself.

What you control
UsernameThe bot's @handle
Profile pictureUpdated live from the dashboard
Bio / descriptionEditable any time
PlatformProfile changesWhy
TelegramApply instantlyTelegram has no automated-edit penalty
X (Twitter)Handled manually by the teamFrequent automated edits risk a shadow ban
Identity is separate from the model

Renaming the bot or swapping its picture never affects the trained character model.

X (Twitter) Agents

Overview

An X agent is a Memescale bot that posts to a real X account. The Twitter Combo bundles a verified X account, the X API plan, dedicated compute, and a matching Telegram bot on the same character — all for $499/month.

What an X agent bundles
Verified X account
X API plan
Dedicated compute
$499
per month
Twitter Combo is the X tier

Twitter Combo bundles a verified account, the required X API plan, dedicated compute, AND a matching Telegram bot into one $499/month price.

What the Twitter Combo includes

  • A verified X account for your character.
  • The X API plan needed to post automatically.
  • Dedicated compute, so posts generate fast.
  • A matching Telegram bot running the same character — included.
Telegram and X together

Every Twitter Combo runs the same character on both X and Telegram. No separate purchase needed.

Module

Plans & Accounts

Pricing, billing, what happens when you pause a bot, and how account security is enforced.

Plans & Billing

Pricing, billing, and pausing

Plans & Pricing

Overview

Memescale has free and paid plans. Every plan generates 1024x1024 images and unlimited volume; paid plans differ on compute, channels, and character count. Multi-character and professional dataset creation are optional add-ons.

PlanPriceWhat it is
Custom BotFreeBring your own bot token, one character
Telegram Shared$99/moYour own bot on shared compute
Telegram$299/moYour own bot on dedicated compute
Twitter Combo$499/moX agent + matching Telegram bot, dedicated

What is the same on every plan

  • 1024x1024 images by default.
  • Unlimited generations — no credits.
  • A free gallery website.

Add-ons

  • Multi-character — add extra characters to a dedicated bot.
  • Professional dataset creation — the team prepares your training images for you.
Custom aspect ratios

Dedicated plans can generate non-square aspect ratios at no extra cost. Shared plans are fixed at 1024x1024.

Billing & Plan Changes

Overview

Billing is monthly and paid manually in cryptocurrency. A 24-hour grace period applies before a bot is paused for non-payment. Plan changes take effect at the next billing cycle.

Billing cycle
Monthly crypto payment
24h grace period
Bot keeps running
How billing works
CycleMonthly
PaymentManual cryptocurrency payment
Grace period24 hours after the due date
Account creationAutomatic — paying creates your account

Grace period

If a payment is late, the bot keeps running for 24 hours. Pay within that window and nothing is interrupted. Miss it and the bot is paused — but never deleted.

Changing plans

Upgrades and downgrades take effect at your next billing cycle, so you always get the full period you paid for. Your trained model carries over unchanged.

Stopping is not losing

If you stop paying entirely, your model is preserved indefinitely and the bot can be reactivated the same day at current pricing.

Pausing & Reactivating

Overview

Stopping payment never destroys your work. The trained model is kept indefinitely, and reactivation happens the same day at whatever pricing is current then.

Pause & reactivate
Stop paying — bot paused
Model archived indefinitely
Reactivate same day
Your model is safe

A paused account keeps its trained model and training images. Nothing is deleted for non-payment.

  • Stop paying → the bot is paused, the model is archived.
  • Want it back → reactivate and the bot is live again the same day.
  • Reactivation uses the pricing in effect at that time.
Deletion is separate

Data is only removed if you explicitly request deletion — see the data retention section.

Account Security

How your account is protected

Account Security

Overview

Sessions are cryptographically enforced. Memescale never holds your private keys and never accesses your wallet — payment is the only point of contact with crypto.

Where the line sits
Memescale
  • Cryptographic sessions
  • Receives the payment you send
Never Memescale
  • Holds your private keys
  • Initiates a transaction
  • Sessions are protected by cryptographic proof, not just a password.
  • Memescale never stores or sees your wallet private keys.
  • The platform never initiates a transaction from your wallet.
You hold your keys

Memescale only ever receives a payment you send. It cannot pull funds — there is nothing on our side that could.

Bot Owner Identity

The bot owner is identified by Telegram user_id, not username. At signup, the owner's username is captured and the user_id is bound on first contact. user_id is the authoritative check for owner-only commands like /authorize. Usernames are mutable on Telegram; changing your @handle does not affect ownership because the user_id binding is durable.