Installation Guide

Prerequisites

System Requirements:

  • Operating System: Windows 10/11

  • Internet connection for setup

Recommended Software:

  • Visual Studio Code - For easy file editing and terminal access

Installation Steps

Step 1: Download and Extract

  • Download the latest release ZIP file from the Discord

  • Extract to your desired location (e.g., C:\bundler-bot)

  • Avoid paths with spaces or special characters

Step 2: Verify Files

Your extracted folder should contain: bundler-bot-v1.0.0/ ├── bundler-bot.exe ← Main executable ├── package.json ← For npm start support ├── .env ← Configuration file ├── metadata.json ← Token metadata template ├── pumpfun-IDL.json ← Program interface ├── src/keypairs/ ← Wallet storage (empty initially) ├── logs/ ← Transaction logs ├── token/ ← Token data ├── resources/ ← Rust binaries for vanity gen └── README.md ← Documentation

Step 3: .env Setup

Open the .env file (recommended in VS Code for ease of use) and configure - see .env Setup Guide

Note: Bot will not work until .env is set up

Step 4: Test Installation

Open the bot folder in your desired terminal and run: npm start

You should see:

  • Bot logo and version

  • Configuration loading messages

  • Main menu options

Step 5: Initial Setup Check

The bot will attempt to load your configuration. You may see errors like:

  • "SOLANA_RPC_URL must be set"

  • "LICENSE_KEY must be set"

This is normal! These will be resolved when you configure .env.

Opening with VS Code (Recommended)

  1. Open VS Code

  2. File → Open Folder

  3. Select the folder you extracted from the ZIP

Benefits of using VS Code:

  • Easy .env file editing with syntax highlighting

  • Built-in terminal for running commands

  • File explorer for managing wallets and logs

  • Better error highlighting and validation

Common Installation Issues

"npm start command not found"

  • Ensure you're in the correct folder

"Files are missing after extraction"

  • Some antivirus software may remove files

  • Add extraction folder to antivirus exclusions

  • Re-extract the ZIP file

VS Code won't open folder

  • Ensure VS Code is installed correctly

  • Try "Open with Code" from Windows context menu

  • Restart VS Code if needed

Configuration Files:

  • .env - Your main configuration (RPC, keys, etc.)

  • metadata.json - Token metadata template

  • package.json - Enables npm start command

Next Steps

✅ Installation Complete!

Now proceed to:

  1. .env Setup Guide - Set up your .env file

  2. Wallet Management - Create and fund your bundle wallets

Note: The bot executable contains all necessary dependencies - no need to install Node.js, npm, or other software separately!

Last updated