Foxwarm documentation

Foxwarm runs on your machine or server. This site provides the installer and the documentation for setting up and using your own instance.

Start here

Install Foxwarm on Linux, macOS, WSL, or Windows.
Set up your first model in the WebUI.
Read Agents, Sessions, and memory to see where identity, conversation history, and long-lived knowledge live.

Model options and routing covers reasoning effort, model aliases, hosted search, and generated images.
Long conversations and history search covers compaction and optional semantic retrieval.
Tools, Skills, and MCP explains built-in actions, reusable instructions, and external tool servers.
Connect an external MCP client shows how to use Foxwarm’s authenticated inbound MCP endpoint.
Nodes covers optional execution environments for another machine, a dedicated environment, or supported browser tools.
Channels shows how to connect Sessions to supported messaging platforms.
Data, upgrades, and backups describes the data directory and how to update an important instance safely.
FAQ answers common installation and configuration questions.

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