Skip to content

2 · Set up your AI workers

What you'll do

Tell TofuFactory which AI assistants it's allowed to use, pick the model each one runs, and decide which kind of work each one handles — all from the Settings screen.

Open Settings

Go to Settings from the app's menu/navigation. This is where everything about your setup lives — workers, spending, alerts, language.

The Settings screen.

Turn on your AI assistants

TofuFactory can drive a few different AI coding assistants (such as Claude, Qwen, and Gemini). On the Settings screen it shows which ones are ready to use.

  • If an assistant is ready, you'll see it listed as available.
  • If one is not installed, there's an Install button next to it — click it and TofuFactory sets it up for you. You don't need a terminal.

The list of AI assistants, one with an Install button.

You don't need all of them. One is enough to start. More just gives the factory options.

Pick a model for each

Each assistant offers its own list of models — think of a model as the "engine," where bigger ones are smarter but cost more. Pick one from each assistant's dropdown. If one assistant has no model choice, that's normal — it simply doesn't offer one.

Rule of thumb: a stronger model for hard, thinking-heavy work; a cheaper, faster one for routine jobs. You can change this anytime.

Decide who does what: Role Mapping

TofuFactory organizes its work into four specialized roles. Instead of choosing an AI assistant every time you create a job, you map each role to one of your enabled assistants:

Role Kind of work Recommended setup
Utility Everyday, routine tasks (boilerplates, docstrings, formatting, cleanups, running tests) A fast, cheap assistant (e.g. Qwen or Claude Haiku)
Planning Strategic research, architecture, multi-file design steps, and spec generation A high-reasoning assistant (e.g. Claude Opus or Gemini Pro)
Chat Interactive steering messages, back-and-forth guidance, and Discord bot responses A conversational, low-latency assistant (e.g. Claude Sonnet)
Incident Diagnostics and repair tasks spawned during production fire drills (P0 issues) Your absolute smartest model available to handle complex emergencies

Point each role to one of your available assistants in the dropdowns. If you only have one assistant ready, point all four roles to it. The factory will still function perfectly, it just won't specialize.

Advanced worker settings

For deeper control, scroll down to the Advanced Worker Configurations section on the Settings page.

1 · Priority Order

The Priority Order list tells the factory which agent to use as a fallback if your primary assigned assistant hits a rate limit or goes offline. - Drag and drop the assistants in the list to rearrange them. - The assistant at the top has highest priority. If it's busy or rate-limited, TofuFactory automatically steps down to the next one on the list, preventing your queues from blocking.

2 · Custom paths & binary overrides

If you installed an assistant CLI manually in a custom location, or want to use a specific version (e.g. a pre-release or local testing build), you can tell TofuFactory exactly where to find it: 1. Locate the assistant CLI under the Binary Paths sub-section. 2. Toggle Custom Path and paste the absolute path to your CLI executable (for example, C:\tools\bin\claude.exe or /usr/local/bin/qwen). 3. Click Verify Path. The status will turn green if the app successfully communicates with the executable.

Power user: everything above is also saved to a plain text file — config/agent_preferences.toml in your workspace (or under your custom TOFU_DATA_DIR). You never need to touch it; the Settings screen is the normal way. But if you want to copy your setup between machines or edit it offline, that file holds the roles, priority order, and binary paths, and the app re-reads it the next time a job starts.

You should now see

  • At least one AI assistant marked as ready to use.
  • A model chosen for each one you turned on.
  • The four roles each pointing at an assistant.

If something's not right

Problem What to do
An assistant I installed still shows as not ready Reopen Settings to refresh, or restart the app.
No models to pick for one assistant Normal for some — they don't offer a model choice.
Install button didn't work Try again; if it keeps failing, that assistant may need a separate sign-in or account the app can't set up for you.
Custom binary path is rejected Ensure you specified the full path including the executable file name (not just its folder) and that the app has permissions to execute it.

Next

3 · Set a spending limit — put a cap on what the work can cost before you let it loose.