Skip to main content
Use Laguna XS.2, Ollama, and Poolside Agent CLI to run a coding agent with an open-weight model on your own hardware. Laguna XS.2 is released under Apache 2.0. With this setup, Ollama serves the model locally and pool connects to it from your project directory. Your code and model traffic stay on the machine where you run the local model server.

Related demo: one-command install on DGX Spark

​
How it works

A local Poolside agent uses four pieces:
  • Laguna XS.2: The model. Laguna XS.2 has 33B total parameters and 3B active parameters per token.
  • Ollama: The local runtime. Ollama pulls the model and serves it through an OpenAI-compatible endpoint on your machine.
  • Poolside Agent CLI: The terminal-based coding agent. Use the pool command to work with the local model from your project directory.
  • ACP editors: Editors compatible with the Agent Client Protocol (ACP), such as JetBrains and Zed, can use the same local agent through ACP.

​
Prerequisites

Before you install the local agent, check that your machine has enough memory, GPU support, and disk space for the model you want to run.

​
Hardware

Laguna XS.2 can run locally on the following hardware: On NVIDIA systems, Blackwell, Hopper, and Ada GPUs are recommended. Turing and older GPUs may work, but they are not recommended. Use hardware that meets these minimums:
  • 32 GB system RAM.
  • 8 GB VRAM on discrete NVIDIA GPUs.
  • Enough free disk space for the selected model tag plus 8 GB on the Ollama models volume.

​
Memory and context

Model weights and KV cache share memory while the model runs. Use a context length that fits the memory available on your machine.

​
Steps

To run a Poolside coding agent locally, set up Ollama, pull Laguna XS.2, install Poolside Agent CLI, and start an agent session from your project directory.

​
Step 1: Install Ollama

Install Ollama:
Confirm Ollama is available:

​
Step 2: Choose and pull a model tag

The default Ollama tag is laguna-xs.2:latest, which uses the same model blob as laguna-xs.2:q4_K_M. Use a different tag when you want higher precision and have enough memory. Pull the tag you want to run. For example, to pull the default tag, run:

​
Step 3: Test the model in Ollama

You can chat with the model directly through Ollama to confirm it works. Use the same tag you pulled in the previous step:

​
Step 4: Install Poolside Agent CLI

Install Poolside Agent CLI so pool can connect to the model that Ollama serves locally:
Verify the installation:
The command prints the installed version. For installation details, see Install Poolside Agent CLI.

​
Step 5: Launch pool against the local model

Go to the project directory you want to work in, then point pool at the model Ollama serves on your machine. Use the same tag you used in step 2. This example uses laguna-xs.2:latest:
When the session starts, send a prompt:
You know the setup worked when the agent responds using the local Laguna XS.2 model.

​
Optional: Work in your editor

Because pool supports ACP, you can connect the same local agent to any ACP-compatible editor instead of working from the terminal:

​
Next steps

Learn what you can do with pool

Keep working in the terminal with interactive sessions, automation, and other Poolside Agent CLI workflows.

Configure your agent

Shape agent behavior and control what it can do.