Buffaly Logo
Default installer

Install Buffaly locally.

Use the default Windows installer to set up Buffaly locally. You do not need Visual Studio, and you do not need to build from source to start using Buffaly.

Download

Download the latest Buffaly setup MSI for Windows. The installer sets up the local Buffaly app, bundled skills, web modules, and provider modules so you can start using Buffaly without cloning the source or opening Visual Studio.

After installation, launch Buffaly from the Start Menu, open the local UI, and connect OpenAI from the settings screen. You can inspect the source later if you want to understand or customize the runtime.

Download Buffaly Installer

Install steps

  1. Download the Buffaly setup MSI.
  2. Run the installer.
  3. Launch Buffaly from the Start Menu shortcut.
  4. Configure OpenAI credentials before running agent tasks. You can use an OpenAI API key, or use the Codex backend path to reuse an existing Codex/OpenAI subscription when your install supports it.
  5. Open the local Buffaly UI and run a first prompt.

What the default installer includes

The default installer packages the local Buffaly runtime with a practical starter set of skills, web modules, and model provider modules. It is meant to let you start using Buffaly before you decide whether to inspect or modify the source.

Included skills

Skills are the capabilities Buffaly can discover and use. Some are prompt-only workflows; others expose typed tools backed by local code, services, or web modules.

BuffalySelfManagement

Tools and prompts for maintaining Buffaly itself: adding DLL-backed capabilities, exposing C# classes, troubleshooting runtime behavior, and improving ontology/code organization.

FileSystem

Safe local file and directory operations such as reading files and searching text. This is the basic inspection layer for local projects and artifacts.

GoogleWorkspace

Google account authorization plus Workspace actions for Docs, Calendar, Chat, and related account-bound workflows.

HealthcareData

Starter high-trust healthcare data handling prompts and patterns, including guidance for keeping sensitive patient data inside bounded runtime workflows.

Level2Watcher

Supervisory/session-watcher capability used to review agent progress, catch drift, and keep longer-running work aligned with the user goal.

LLM

Model-facing actions and provider/model utilities for prompting, image generation, and provider runtime selection.

LocalTask

Durable local task files for multi-step work. Use this when a task needs requirements, acceptance criteria, progress history, and resumability.

Process

Command-line and PowerShell execution tools for local diagnostics, builds, scripts, and other controlled process operations.

Services

Service discovery and inspection tools for understanding available runtime services and module surfaces.

SessionHistory

Tools for reading, paging, and summarizing prior session history so work can be resumed or audited.

SessionManagement

Session maintenance, archive, compaction, and lifecycle capabilities used to keep local Buffaly workspaces healthy.

SessionSync

Session search and synchronization workflows for finding related prior work and keeping session context connected.

TicketManagement

Scratch-pad ticket workflows for creating, updating, explaining, removing, or completing lightweight tickets across sessions.

Wiki

Wiki article creation, editing, refresh, insertion, audit, and cross-link repair workflows for project documentation.

Included web modules

Module What it adds
HeartbeatA low-level health module that lets the host confirm module loading and runtime availability.
WikiBackend support for wiki/documentation workflows exposed through the Wiki skill.
SkillManagementRuntime support for inspecting and managing installed skills and capability metadata.
GoogleWorkspaceAccount and authorization UI for Google Workspace integrations, including connected account management.
BrowserBrowser workbench UI for browser-based automation and inspection workflows.
ComputerUseOpenAI computer-use workbench for tasks that need visual computer interaction through a controlled UI.
OpenAIImageGenerationImage generation workbench for OpenAI image-generation tasks and local review workflows.

Available model providers

The default install currently has four providers available. OpenAI is built into the Buffaly host/provider catalog. xAI, Gemini, and Anthropic are loaded as dynamic provider modules.

OpenAI authentication: API key or Codex backend

OpenAI can be used in two ways. The direct API-key path uses an OpenAI API key for model calls. The Codex backend path can reuse an existing Codex/OpenAI subscription when your installation is configured for Codex backend authentication.

Use the API-key path when you want straightforward API billing and service-account style setup. Use the Codex backend path when you already use Codex and want Buffaly to route through that authenticated backend instead of entering a separate API key.

OpenAI

Provider key: openai. Built-in provider for OpenAI models. Supports normal API-key based use, and can also be paired with the Codex backend path when configured so users can reuse an existing Codex/OpenAI subscription.

xAI

Provider key: xai. Dynamic module for Grok/xAI model access when you want to run Buffaly tasks against xAI models.

Gemini

Provider key: gemini. Dynamic module for Google Gemini model access and Gemini-native execution paths.

Anthropic

Provider key: anthropic. Dynamic module for Anthropic Claude model access.

Next: run the quickstart

After the installer is running and OpenAI credentials are configured, use the quickstart to create your first prompt skill, ProtoScript action, and DLL-backed action.

Open Quickstart