Documentation

How to use LMInsta

A complete step-by-step guide to setting up and using every feature of the LMInsta desktop app — from license activation to creating your first post and beyond.

Getting Started

Everything you need to go from zero to your first post.

What is LMInsta?

LMInsta is an AI-powered Instagram workspace that runs entirely on your desktop. It helps you create brand characters, write captions in 13+ tones, generate images, craft smart hashtags, reply to DMs, and manage your content — all from a single app. Your data never leaves your machine.

Prerequisites

  • macOS or Windows computer
  • LM Studio installed (free, local AI) — or an OpenRouter API key (cloud AI)
  • Gemini API key (required only for AI image generation)
  • An Instagram account

Quick Overview

1Get your license key
2Install the app & activate
3Configure AI providers
4Add your Instagram account
5Create a character persona
6Create & save your first post
01

Get Your License Key

Why do I need a license?

A license key activates the LMInsta desktop app on your device. Each license allows up to 2 device activations, so you can use LMInsta on both your desktop and laptop.

  1. 1
    Create an account — Go to Sign In and sign in with your Google account. This creates your LMInsta account automatically.
  2. 2
    Choose a plan — Visit the Pricing page and select either Monthly ($12/mo) or Yearly ($99/yr — save $45). Both plans include every feature.
  3. 3
    Complete checkout— You'll be redirected to iyzico's secure checkout. Enter your payment details and confirm. A license key is generated automatically after successful payment.
  4. 4
    Find your license key — After payment, go to your Dashboard. Your license key will be displayed in the format LMI-XXXXXX-XXXXXX-XXXXXX. Click the copy button to copy it to your clipboard.
Tip: Keep your license key safe! You can always find it again on your Dashboard, but you'll need it during the app setup.
02

Install & First Launch

  1. 1
    Download the app — Go to the Downloads page and download the installer for your operating system (macOS or Windows).
  2. 2
    Install — Run the downloaded installer:
    • macOS: Open the .dmg file and drag LMInsta to your Applications folder.
    • Windows: Run the .exe installer and follow the prompts.
  3. 3
    Launch LMInsta— Open the app. On first launch you'll see the Dashboard with a connection status indicator.
  4. 4
    Activate your license — Navigate to Settings (bottom of the sidebar). Find the License Key section, paste your license key, and click "Validate License". You'll see a success confirmation when your device is activated.
Tip: Each license supports 2 devices. If you need to move your license to a new device, contact support.
03

Configure AI Providers

LMInsta uses AI for captions, hashtags, DM replies, and image generation. You need to configure at least one text AI provider before using content features.

Text AI — Choose Your Provider

Option A: LM Studio (Local & Free)

  1. 1. Download and install LM Studio from lmstudio.ai
  2. 2. Download a model (e.g. Mistral, Llama)
  3. 3. Start the local server in LM Studio
  4. 4. In LMInsta Settings, select LM Studio as provider
  5. 5. Enter the URL (default: http://localhost:1234/v1)
  6. 6. Select your model from the dropdown
  7. 7. Click Save

✅ Free, private, no API key needed

Option B: OpenRouter (Cloud)

  1. 1. Create an account at openrouter.ai
  2. 2. Generate an API key
  3. 3. In LMInsta Settings, select OpenRouter as provider
  4. 4. Paste your API key
  5. 5. Select a model from the dropdown
  6. 6. Click Save

☁️ No local setup, pay-per-use

Image AI — Gemini (Optional)

If you want to use the AI Image Generator, you need a Gemini API key. This is separate from the text AI provider.

  1. 1. Go to Google AI Studio and create an API key
  2. 2. In LMInsta Settings, find the Gemini Configuration section
  3. 3. Paste your Gemini API key
  4. 4. Select an image model from the dropdown
  5. 5. Click Save
Tip: The Dashboard shows a live connection indicator — green means connected, red means offline. Check it after configuring to confirm everything works.
04

Add Your Instagram Account

LMInsta manages Instagram accounts through the Accounts page. You need at least one active account to use automation features.

  1. 1
    Navigate to Accounts in the sidebar (user icon).
  2. 2
    Click "Add Browser Account" in the top right.
  3. 3
    Enter your Instagram username in the input field and confirm.
  4. 4
    Click on the account card's radio button to set it as the default account. The active account gets a purple highlight with a checkmark.
  5. 5
    Sign in to Instagram — Use the Instagram Workspace panel on the right side of the app. This is an embedded browser where you log into Instagram directly. Your password is never stored by LMInsta.

How does the Instagram panel work?

The right side of LMInsta shows an embedded Instagram browser. You log in directly through Instagram's website — just like using Chrome. This is where automation happens. Your session stays active as long as the app is open.

Tip: You can add multiple accounts and switch the default at any time. Only the default (active) account is used for automation.
05

Create a Character

Characters are AI-powered personas that give your content a consistent voice. Every caption, DM reply, and post generated will match the character's personality. Think of it as your brand's digital identity.

  1. 1
    Navigate to Characters in the sidebar.
  2. 2
    Click "New Character" (the + button).
  3. 3
    Enter a name— This is your character's display name (e.g. "Luna the Lifestyle Brand").
  4. 4
    Select a type:
    👤

    Human

    Personal brands, influencers

    🐾

    Animal

    Pet accounts, mascots

    🏢

    Company

    Business, product pages

  5. 5
    Write a description— Brief overview of who or what this character is (e.g. "A minimalist lifestyle blogger who loves coffee and travel").
  6. 6
    Link an Instagram account (optional) — Select which account this character posts from.
  7. 7
    Generate the Soul — This is the most important part. Click "Generate with AI" to automatically create a detailed personality profile based on your name, type, and description. The AI writes a rich Markdown description covering voice, tone, topics, and posting style.

    You can also write or edit the soul manually in the textarea.

  8. 8
    Save your character. You can also upload reference images for the character.
Tip: The character's soul is what makes AI-generated content consistent. The more detailed the soul, the better your captions and replies will match your brand voice.
06

Create Your First Post

The Create Postpage is a 4-step wizard that takes you from choosing media to saving your post. It's the core workflow of LMInsta.

1

Media

  • Select a character from the dropdown (or use the default account).
  • Upload an image — Drag and drop or click to browse. You can also use an image generated from the Image Generator.
  • Preview your media, then click Next.
2

Caption

  • Enter a topicfor your caption (e.g. "morning coffee routine").
  • Pick a tone — Choose from 17+ styles including Casual, Professional, Witty, Motivational, Poetic, Bold, Sexy, Mysterious, and more.
  • Select your language (English or Turkish).
  • Click "Generate Caption"— The AI will generate multiple options based on your character's soul, tone, and topic.
  • Select your favorite caption or copy it to a custom text area to edit.
3

Hashtags

  • Click "Suggest Hashtags" — The AI analyzes your caption and topic to generate relevant hashtags.
  • Hashtags are organized into 3 reach tiers:
🔴 High (1M+ posts)
🟡 Medium (100K–1M)
🟢 Niche (<100K)
  • Click any hashtag to copy it individually, or use "Copy group" to copy an entire tier.
4

Share

Review your post and save or share it:

Copy Caption + Hashtags

One click to copy both your caption and hashtags to the clipboard, ready to paste into Instagram.

Save

Save the post to your archive. Browse it later from the Posts page.

You can also use "Inject Photo to Composer"to load the image into Instagram's web composer, then paste your copied caption and hashtags manually.

Caption Generator

Standalone tool for generating Instagram captions without the full Create Post workflow.

The Caption Generator is a focused tool for quickly generating captions. Navigate to it from the sidebar under Content.

  1. 1
    Enter a topic— Describe what your post is about (e.g. "summer vacation in Bali", "new product launch").
  2. 2
    Select a tone from the dropdown — Casual, Professional, Witty, Motivational, Inspirational, Humorous, Storytelling, Educational, Promotional, Minimalist, Poetic, Bold, Sexy, Seductive, Tempting, Flirty, Mysterious, Provocative.
  3. 3
    Choose your language (English or Turkish).
  4. 4
    Click "Generate Caption".
  5. 5
    Review the generated captions — each shows the caption text and a tone badge. Click the copy icon on any caption to copy it to your clipboard.

Hashtag Suggester

Generate smart hashtags grouped by discoverability.

  1. 1
    Enter a topic(required) — e.g. "fitness motivation", "vegan recipes".
  2. 2
    Optionally paste your caption for better context.
  3. 3
    Click "Suggest Hashtags".
  4. 4
    Results appear in 3 groups:
    • High reach (1M+) — Popular hashtags for maximum visibility
    • Medium (100K–1M) — Balanced hashtags for good engagement
    • Niche (<100K) — Targeted hashtags for specific audiences
  5. 5
    Click "Copy group" to copy all hashtags in a tier, or click any individual hashtag to copy just that one.

Image Generator

Create stunning visuals with AI-powered image generation.

Requirement

The Image Generator requires a Gemini API key configured in Settings. Make sure you've completed Step 3 above.

  1. 1
    Navigate to Image Gen in the sidebar.
  2. 2
    Enter a descriptionof the image you want (e.g. "A cozy coffee shop interior with morning sunlight and plants").
  3. 3
    Click "Refine with AI" (optional) — The AI rewrites your prompt to be more optimized for photo generation.
  4. 4
    Select an aspect ratio:
    1:1 Square4:5 Portrait9:16 Story16:9 Landscape4:33:4
  5. 5
    Click "Generate Image" and wait for the result.
  6. 6
    Use your image — Hover over the result and choose:
    • Share to Create Post — Sends the image directly to the Create Post wizard
    • Download — Save the image to your computer

DM Reply Assistant

Generate intelligent replies to Instagram direct messages.

  1. 1
    Navigate to DM Reply in the sidebar (under Automation).
  2. 2
    Select a character (optional) — If you select a character, the AI uses their soul/personality to craft replies.
  3. 3
    Paste the incoming DM— Copy the message you received and paste it into the "Incoming message" textarea.
  4. 4
    Add persona guidance(optional) — Extra direction like "Keep it professional but warm" or "Be playful and humorous". This adds nuance on top of the character's soul.
  5. 5
    Click "Generate Reply".
  6. 6
    Review the multiple reply options— each comes with an "angle" tag (e.g. Warm, Playful, Direct). Click the copy button on your favorite to use it.

Post History

Browse, filter, and manage all your created posts.

Every post you create is saved to the Posts page. Navigate there from the sidebar.

Filtering & Sorting

  • By Character — View posts from a specific character or all characters.
  • By Status — Filter by Archived or Failed.
  • Sort — Newest first, Oldest first, or alphabetically by status.

Post Status Colors

Archived
Failed

Dashboard

Monitor your system health and AI connection status.

The Dashboard is your home screen. It shows:

  • Connection Status — A live indicator showing whether your AI provider (LM Studio or OpenRouter) is connected. Green = connected, Red = offline.
  • Provider Toggle — Quickly switch between LM Studio and OpenRouter.
  • LLM Settings — Click the connection card to expand and adjust your provider URL, API key, and model selection.
  • Recent Activity — The last 10 AI operations you ran (captions generated, hashtags suggested, etc.) with timestamps and results.

Ready to get started?

Download LMInsta and create your first AI-powered post in minutes.