Skip to content
FoxwarmFoxwarmFoxwarm

Foxwarm documentation

Run AI agents with persistent Sessions, tools, memory, and optional execution Nodes and messaging Channels on your own machine or server.
Install FoxwarmSet up a model

This site hosts Foxwarm documentation and installer downloads. The WebUI and API run on your machine or server.

Install and open WebUI

Use the Linux/macOS/WSL shell installer or the native Windows PowerShell installer, then open the local token URL it prints.

Connect your model

First-run Setup saves your model provider, endpoint, model ID, and API key when the endpoint requires one.

Keep work organized

An Agent holds a workspace and long-lived memory. Its Sessions are separate conversation threads.

Add what your workflow needs

Start with WebUI and built-in tools. Load Skills or add MCP servers, Nodes, and messaging Channels when you need them.

Where to start

Section titled “Where to start”
  1. Install Foxwarm and keep the program checkout separate from its data directory.
  2. Set up your first model in the WebUI first-run screen.
  3. Read Agents, Sessions, and memory to see where identity, conversation history, and curated knowledge live.
  4. Learn how Foxwarm uses Tools, Skills, and MCP.
  5. Add Nodes or Channels when your workflow needs them.
  6. Read Data, upgrades, and backups before moving an important instance.

For implementation details, start with the repository Code Index. The source code and tests define current behavior.