Libra Documentation

Libra is a framework for building and operating agent systems. It gives you a runtime harness for composing agents with memory, tools, skills, sandboxes, and subagents, and it also provides an application layer that turns those capabilities into a usable product experience.

This documentation is organized around those two parts:

• Harness: the core SDK and runtime layer for building your own agent system.
• Application: a reference application built on top of the Harness for deployment, operations, and end-user workflows.

If you want to understand how Libra works, start with the Introduction. If you want to build on the core runtime, go to the Harness docs. If you want to deploy and use Libra as an application, go to the App docs.

Start here

If you are new to Libra

Start with the conceptual overview first.

• Introduction
• Harness vs App

If you want to build with Libra

Start with the Harness section. This path is for teams who want to integrate Libra capabilities into their own system or build a custom agent product on top of the Libra runtime.

• Harness
• Quick Start
• Configuration
• Customization

If you want to deploy and use Libra

Start with the App section. This path is for teams who want to run Libra as a complete application and understand how to configure, operate, and use it in practice.

• Application
• Quick Start
• Deployment Guide
• Workspace Usage

Documentation structure

Introduction

The Introduction section helps you build the right mental model before you look at implementation details.

• What is Libra explains what Libra is and what problems it is designed to solve.
• Why Libra explains the motivation behind the project.
• Core Concepts introduces the concepts that appear across the documentation.
• Harness vs App explains the relationship between the runtime layer and the application layer.

Harness

The Harness section is the core of the technical documentation. It is written for developers who want to build their own Libra-based system.

• Quick Start shows how to create your first harness with the core Libra API.
• Design Principles explains the architectural ideas behind the Harness.
• Configuration covers the main configuration surface of the SDK/runtime.
• Memory, Tools, Skills, and Sandbox explain the major system capabilities separately.
• Customization shows how to adapt Libra to your own product requirements.
• Integration Guide explains how to integrate the Harness into a larger system.

Application

The App section is written for teams who want to deploy Libra as a usable product.

• Quick Start helps you run the application locally.
• Deployment Guide explains how to deploy Libra in your own environment.
• Configuration covers the application-level configuration model.
• Workspace Usage explains the main user workflows.
• Agents and Threads explains how users interact with Libra in practice.
• Operations and Troubleshooting covers maintenance and production usage.

Tutorials

The Tutorials section is for hands-on, task-oriented learning.

• Tutorials

Reference

The Reference section is for detailed lookup material, including configuration, runtime modes, APIs, and source-oriented mapping.

• Reference

Choose the right path

• If you are evaluating the project, start with Introduction.
• If you are building your own agent system, start with Harness.
• If you are deploying Libra for users, start with Application.
• If you want to learn by doing, go to Tutorials.