1. Open the Script Generator application.
2. Select the settings button (bottom left) then "Edit Config File" button, which opens the config.yaml file using any text editor (like Notepad).
3. Find the ai_provider setting and set it to either "gemini" or "openai".
4. Paste your API key into the respective api_key: "" field for your chosen AI provider. You can also change the model for your chosen AI. Currently the default Gemini Flash 3/3.1 has the best results. Feel free to experiment with newer models once you understand how the app works.
5. Save the file.

1. From the main dashboard, click on Create New Project to open the setup wizard.
2. Details: Enter your "Project Name" and a brief "Project Niche" (e.g., Cryptocurrency meme project).
3. Information (Crucial Step): You have three options to feed the AI context about your project:
   • Scrape Website: Enter comma-separated URLs (e.g., your project's website or whitepaper). The AI will scrape this live.
   • Import File: Upload a .txt or .md file containing detailed project info.
   • Skip: Only skip if you intend to add info manually later.
4. Proceed to the Generate step. The tool will take about 60+ seconds to process your data, build realistic actor profiles (Members and Moderators), and generate the foundational prompt sets (niche, general, Solo, etc).

1. Select your project and click the "Generate Script" button.
2. Choose how many 24 hour scripts you want to generate in parallel (Max 5).
3. Monitor the generation progress on your dashboard. Once finished, you can view the scripts directly.

1. Open the Chatter Bot application.
2. Click the "Settings" button (bottom left) then click "Open" under Global Config, which opens the global_config.yaml file in a text editor.
3. Under api_credentials, input the api_id and api_hash which you can generate from my.telegram.org. You can add multiple sets to rotate automatically (recommended).
4. Save the file.

Organize your purchased or generated Telegram .session files into the correct folder structures so the bot can distinguish account roles. Navigate to your workspace and arrange them like so:

• Mod Accounts: Place session files inside folders prefixed with M_ (e.g., M_447xxxxxxxxx/447xxxxxxxxx.session).
• Relay Accounts: Place them inside folders prefixed with R_ (e.g., R_447xxxxxxxxx/447xxxxxxxxx.session).
• Standard Chatter Accounts: Place inside regular folders (e.g., 447xxxxxxxxx/447xxxxxxxxx.session).

sessions/
 ├── M_447123456789/       # Mod Account
 │    └── 447123456789.session
 ├── R_447987654321/       # Relay Account
 │    └── 447987654321.session
 └── 447555666777/         # Standard Member Account
      └── 447555666777.session

1. From the main dashboard, click the "Create Session File" button under Quick Actions to launch the account creation tool.
2. Enter the phone number for the Telegram account and select its intended role: either 'Regular Chatter' or 'Mod Account'.
3. Click "Send Verification Code", input the code received via Telegram, and finish creating the session file. Repeat this process as needed.

1. Click "Select Project" under the Dashboard Quick Actions and click "New Project" at the top right of the window.
2. Project Name: Type the exact same project name you used in the Script Generator for continuity.
3. Group Configurations: Provide the links for your required telegram groups:
   • Target Group Link: The main public group where bots will send the scripted messages.
   • Bot Home Group Link: A private, isolated group containing your bot accounts so their identities can be managed and verified.
   • Relay Group Link (Optional): A group where real user messages will be forwarded to you via notifications in the app.

1. Once your setup is complete, navigate to your project dashboard within the Chatter Bot.
2. Copy and paste the scripts generated from the Script Generator into your project's Scripts folder. You can quickly access this by clicking the "Scripts" button on the dashboard.
3. Open the Live Monitor View and click "Start Bot" to officially run the bot and watch the simulation occur in real time.
4. The bot will automatically move to the next script once the current one is finished. If the bot is paused or closed, it will resume from where it left off in the last opened script.
5. Session Health Management: Use the "View Healthy" and "View Unhealthy" buttons on the dashboard to monitor your account status:
   • Healthy: Contains sessions that are active and ready for use.
   • Unhealthy: Contains sessions that have encountered authentication errors.
   • Maintenance: Some session files may occasionally be moved to "Unhealthy" in error. If this happens, you can move them back to the healthy folder to retry authentication.
   • Persistent Issues: if the session still won't authenticate, it may be banned or the file itself may be corrupted.
   • Security Tip: Avoid using poor-quality session files or IPs from inconsistent countries, as this is a common cause of instant account bans.

The Script Generator relies on two main YAML files to control AI logic, profile generation, and script timing.

1. Global Settings (config.yaml)

2. Project Event Mix (events.yaml)

Use these settings to balance the conversation types for a specific project. Note: All weights must total 100.

The Chatter Bot settings focus on account security, rotation, and real-time interaction parameters.

1. Global Bot Settings (global_config.yaml)

2. Project Group Settings (config.yaml)

1. Open the Script Generator app and click the "Project" button on the left navigation bar.
2. Click "Edit Prompts" next to your project. This will open the project's prompts folder on your computer.
3. In this folder, you will find several YAML files that control different types of conversation "events."

Each file in the prompts directory targets a specific type of interaction within your Telegram group:

• General Event Prompts: Universal conversation triggers not specific to your project (e.g., small talk, general crypto sentiment & global events).
• Niche Event Prompts: Focused strictly on your project details (e.g., tokenomics, roadmap, specific utility).
• Solo Member Prompts: Events involving a single member that don't trigger replies (e.g., saying "Good Morning" or a greeting).
• Solo Mod Prompts: Moderator-only messages used for project updates, warnings, or official announcements.

Open any of the files listed above with a text editor to remove or add your own custom prompts. The AI uses these as core instructions when building your script.

prompts:
  - "member asks if anyone else is worried about WWIII and people share their opinions"
  - "member mentions they just moved into a new neighbourhood and they regret their decision"
  - "member asks how everyone's day is going, people share mixed opinions"

1. Open the Script Generator application and click on the Project navigation button.
2. Locate your project and click the "Edit Prompts" button. This will automatically open the locally stored prompts folder for your project.
3. In this folder, find and open the meme_event_prompts.yaml file using any text editor (like Notepad). This file contains the instructions used by the AI to generate visual meme events.

To define which images should be posted, you must specify an AI text prompt followed by its corresponding image reference file name. The format must follow the YAML structure shown below:

prompts:
  - prompt: "member says they are making tons of money"
    reference_image: making_money_08.gif
  - prompt: "member tells the group good morning"
    reference_image: good_morning_01.gif
  - prompt: "" # Leaving prompt empty will post only the image
    reference_image: random_meme_06.gif

1. All images referenced in your prompt file must be stored in the following directory so the Chatter Bot can retrieve them during execution:
C:\Users\[YourUsername]\Documents\AnkerLabs\Chatter Bot\projects\[YourProject]\images
2. Ensure the file names in your meme_event_prompts.yaml exactly match the files stored in the images folder (including extensions like .jpg or .gif).