Run Your First Bots in GUI Mode
Create an instance, configure it, and connect your first SoulFire bots from the GUI.
When to use GUI Mode
GUI mode lets you run SoulFire, view bots, and change settings without terminal commands.
New users can start with Integrated server (local).
If you already run a remote SoulFire server, use Dedicated server (remote) instead.
For the difference, see Operation Modes.
Before you start
- Install the desktop app from Start Here.
- If you want to connect to a remote server, have the server URL and access token ready.
- If you only want to explore the interface,
Demo serveris useful, but it does not connect real bots.
Connect your first bots
Choose how to connect
Launch SoulFire and pick one of the three connection options:
Integrated server (local)for a local first runDedicated server (remote)for an existing SoulFire serverDemo serverto explore the UI without a live backend
Create an instance
Open Instances and click Create Instance. Then give the instance a name. Each instance keeps its own bots, settings, scripts, accounts, proxies, and plugin configuration.
Configure the target server
Open Bot Settings. Set the server address, join delays, protocol version, and timeouts. For most first runs, the defaults are enough except for the target server address.
Add accounts or keep offline mode
If the server allows offline accounts, SoulFire can generate names from the configured format. If you need Microsoft or Bedrock accounts, follow Import Accounts.
Add proxies if you need them
Open Proxy Settings only if you want bots to connect through proxies. If you do, follow Import Proxies.
Start and monitor bots
Return to Overview. Enter the number of stopped bots to connect, then click Start. To connect every stopped bot, click Start all. SoulFire controls each account separately. You can start, restart, or stop one bot from its context menu.
Where common tasks live
- Instances: Create, open, and delete instances.
- Overview: Start, restart, stop, and inspect bots in the current instance.
- Terminal: Run SoulFire commands for the current instance.
- Account Settings: Import Microsoft, Bedrock, or offline accounts.
- Proxy Settings: Import and check proxies.
- Plugins and Plugin Settings: Enable plugins and change their options.
- Scripts: Create and manage visual automation for the instance.
For a fuller map of the interface, see GUI Navigation.
Next steps
- GUI Navigation for a page-by-page UI map
- Automation to choose a scripting or SDK workflow
- Commands for terminal commands
- Install Plugins for built-in and community plugins
- Development if you want to build advanced custom plugins
- Dedicated Mode if you want a long-running remote server
How is this page?
Last updated on