Browse docs Menu

Start here

Docs home Install Buffaly Install on Windows Install on Linux Install on Mac Quickstart How-to library

Learn Buffaly

What Buffaly is User guide Core concepts Coming from other agents Memory and skills

Build and extend

Add a prompt skill Add a ProtoScript skill Add a C# DLL tool Add a model provider Skills, services, and tools ProtoScript services

Operate

Sessions and long-running work Session anatomy Plan, Scratch, and Tasks Session artifacts Session timeline Compaction

Reference

Ontology and ProtoScript Providers and authentication Web modules and UI Diagnostics & recovery Safety rules Secrets handling SmartPatch

Platform installers

Install Buffaly locally.

Choose the package for your operating system. Windows uses the MSI installer. Linux uses a script-first tarball from GitHub Releases. Mac uses an Apple Silicon prerelease tarball from the mac-latest release tag.

Install walkthrough

Watch the Windows setup video.

This walkthrough shows the default local install path: use the packaged Windows installer, launch Buffaly locally, and connect your model credentials before running agent tasks.

Available

Windows

Use the MSI installer for the default local Windows setup, launcher, provisioning flow, and bundled runtime components.

Download MSI Windows install guide

Linux MVP

Linux

Use the GitHub Release tarball for a script-first install. Linux defaults to no-auth, uses external SQL Server, and is operated through shell scripts for install, launch, validation, update, and diagnostics.

Open Linux releases Linux install guide

Public prerelease

Mac

Use the Apple Silicon prerelease tarball from the mac-latest GitHub release tag, then follow the Mac guide to connect PostgreSQL or external SQL Server.

Download Mac tarball Mac install guide

Download source of truth

Public installer artifacts are published through the Buffaly installer GitHub Releases page. Use the release page for Windows, Linux, Mac, checksums, and release notes.

Latest GitHub Release

Windows MSI, Linux tarball, Mac tarball, checksums, and release notes.

Installer repository

Public distribution repository and install README.

Release status

Windows

Default supported installer path through the MSI and Windows provisioning flow.

Linux

Script-first MVP. Use the release page until direct latest tarball aliases are available.

Mac

Planned. Do not use Linux packages on Mac.

Next step

Choose your operating system above, install Buffaly, then continue to Quickstart.