Skip to content

Build your app.
Keep your code.

Start in Cloud or bring your existing codebase. Continue in your editor.
Let LibraOS run the agents, memory, knowledge, and tools.

Extension in Preview · SDK and application source on GitHub

Your development loop
YOUR PROJECT
personal-assistant/
▾ web/
 ▾ src/
  main.tsx
  App.tsx
 package.json
▸ runtime/
// Your application

Your interface.
Your business logic.
Your Git history.

AI capabilities → LibraOS Runtime
$ npm run build Compile your application

Keep your workflow.

Adapt the starter or connect an existing app. Keep the source in your GitHub repository and continue with your editor and coding tools.

Explore the starter source ↗
Illustrated workflow. Follow the starter below to run it with your own models.

From starter to your own app.

Start a project in Cloud, adapt the local starter or integrate the Runtime into an existing codebase.

  1. 01

    Get the code

    Customize a working starter. Build the interface and business logic your product needs.

    Choose a client project →
  2. 02

    Make it yours

    Keep it in your repository. Branch, review, and develop in VS Code with your usual tools.

    Connect your editor →
  3. 03

    Run anywhere

    Test with a local Runtime, then configure hosting, authentication, and routing for your infrastructure.

    Get the Runtime →

VS Code extension · Preview

Stay in your editor.

Connect a model, start the local Runtime, and wire it into your project. Then inspect your agents, memory, and retrieval without leaving VS Code.

VS Code 1.95+ · Docker Compose v2 · A compatible model endpoint. Install from VSIX; the extension is not yet on the Marketplace.

  1. 1
    Install the extension

    In Extensions, choose “Install from VSIX…” and select the downloaded file.

  2. 2
    Configure your model

    Choose an endpoint and model. Test the connection before saving.

  3. 3
    Start the Runtime

    Choose Install Runtime, then Run Local Runtime.

  4. 4
    Initialize your project

    Generate project configuration and a quickstart, then run it in the terminal.

The extension configures and inspects the Runtime; your coding tools write the app. Inference credits and Cloud Deployment are not yet available in the extension.

Compile and run the starter.

Start with the Personal Assistant: a React + TypeScript app with sign-in, streaming chat, conversation history, document Q&A, and memory. Use it as the foundation for your one-sentence build prompt.

GitNode.js 22.12+Docker + ComposePython 3Chat + embedding models
01 / GET THE SOURCE

Your starting project.

Clone the cookbook and prepare its local configuration. The app source stays in your project.

git clone https://github.com/libraos/cookbook.git libraos-cookbook
cd libraos-cookbook
cp get-started/.env.example get-started/.env

Edit get-started/.env using the setup guide: model and embedding endpoints, local secrets, demo password, and sign-in callback. Keep credentials in your local configuration.

02 / CONNECT THE RUNTIME

Give your app its AI.

After configuring the environment, start LibraOS and register the starter app and demo user.

cd get-started
docker compose up -d
curl --fail http://localhost:8900/health
cd ..
bash apps/personal-assistant/scripts/setup.sh

The reference stack includes its database. Check the app README for model, memory, and document-indexing settings. Already run LibraOS? Adapt the app registration and connection settings to your instance.

03 / COMPILE & RUN

Open your app.

From the cookbook root, install dependencies, type-check and compile the frontend, then serve the built app locally.

cd apps/personal-assistant/web
npm ci
npm run build
npm run preview

Open http://localhost:5180. Sign in as demo@example.com with the demo password you configured. Keep LibraOS running; the preview server forwards API requests to it.

Your first real interaction

Ask the assistant a question. Upload a document and ask about it in a new chat. Then check recall in another conversation. Your configured model and Runtime handle the response; the frontend build checks the application code. For production, configure hosting, authentication, and API routing for your environment.

Developer questions.

What do I build with LibraOS?

AI products with agents, memory, knowledge, and tools. Your application owns its interface and business logic. LibraOS supplies the runtime beneath it. The website shows application concepts. Cloud identifies available templates and builds projects from your brief; the Cookbook provides a runnable local starter.

Can I run it on my own infrastructure?

Yes. Start with the Self-Hosted binary for your platform. Air-gapped operation requires local models and connectors, plus validated network and storage configuration. For a hosted option, LibraOS Cloud is in private beta.

Do I own my application code and model choice?

You keep control of the code and business logic you write for your application. Configure compatible model providers and your own credentials; verify support for the models and tools your workflow needs. Runtime licensing is described on the pricing page.

Can I keep developing in GitHub and VS Code?

Yes. Keep your application in your own Git repository and use your normal branch, review, and commit workflow. Open it in VS Code and use the LibraOS extension to configure and inspect the local Runtime. GitHub sign-in is separate from repository access; there is no repository-sync action on this website.

Does the VS Code extension generate my app?

The extension sets up and connects the Runtime. Your editor or coding assistant helps you write application code. The extension is in Preview; inference credits and Cloud Deployment are not available in it yet.

What do the benchmark numbers prove?

The controlled Runtime benchmark measures framework overhead with a mock model. The real-model W10 reports measure specific task outcomes and costs separately. Neither establishes superiority across all production workloads.

How do approvals, security, and pricing work?

Configure permissions, approval points, and audit for the execution path your application uses. External framework tools require separate enforcement. Review security and deployment boundaries and licensing, or contact the team for enterprise requirements.