How to Self-Host an AI Agent on Your Laptop

Most AI tools run in someone else’s cloud. Your prompts, your files, your data, all passing through third-party servers. Self-hosting puts you back in control.

This guide covers setting up PocketPaw as a private AI agent on your own machine. By the end, you’ll have a working assistant that can browse the web, manage files, search the internet, and talk to you through a clean web interface. All running locally.

What You’ll Need

  • A computer running macOS, Linux, or Windows (even an older laptop works)
  • Python 3.11+ installed
  • Either an API key (Anthropic, OpenAI, or Google) or Ollama for free local models
  • About 10 minutes

Step-by-Step Setup

Install PocketPaw

The quickest path is the interactive installer:

Terminal window
curl -fsSL https://pocketpaw.xyz/install.sh | sh

Or install directly with pip:

Terminal window
pip install pocketpaw

For the full feature set (browser automation, memory, desktop tools):

Terminal window
pip install pocketpaw[recommended]

Choose your AI provider

You have two paths: cloud models (smarter, costs money) or local models (free, private, needs decent hardware).

Cloud option, Anthropic Claude (recommended):

Terminal window
export POCKETPAW_ANTHROPIC_API_KEY="sk-ant-your-key-here"

Free option, Ollama (runs on your machine):

Terminal window
# Install Ollama
curl -fsSL https://ollama.com/install.sh | sh


# Pull a model
ollama pull qwen2.5:7b


# Tell PocketPaw to use it
export POCKETPAW_LLM_PROVIDER="ollama"
export POCKETPAW_OLLAMA_MODEL="qwen2.5:7b"
Tip

Ollama models run entirely on your hardware. A 7B parameter model needs about 4GB of RAM. For better results, try a 14B or 32B model if your machine can handle it.

Start PocketPaw

Terminal window
pocketpaw

That’s it. The web dashboard opens at http://localhost:8888. You’re now running your own AI agent.

Try it out

Open the dashboard and try these prompts:

  • “Search the web for the latest Python release notes”
  • “Create a file called notes.txt with today’s date”
  • “What files are in my home directory?”

PocketPaw can execute code, browse websites, read/write files, and use 50+ built-in tools, all from your local machine.

What You Get

A self-hosted PocketPaw instance gives you:

FeatureWhat it does
Web dashboardChat interface at localhost:8888 with session history
50+ toolsWeb search, file management, browser, image gen, voice, OCR
MemoryConversations persist across sessions
Multiple channelsAdd Telegram, Discord, Slack later without reinstalling
SecurityInjection scanning, audit logs, Guardian AI safety checks

Adding Channels Later

Once your agent is running, you can connect messaging platforms:

Terminal window
# Add Telegram
pip install pocketpaw[telegram]
export POCKETPAW_TELEGRAM_BOT_TOKEN="your-bot-token"


# Add Discord
pip install pocketpaw[discord]
export POCKETPAW_DISCORD_BOT_TOKEN="your-bot-token"

Restart PocketPaw and all configured channels start automatically. Same agent, same memory, multiple platforms.

Running on a Home Server

For always-on access, run PocketPaw as a system service:

Terminal window
# Using systemd (Linux)
sudo cp pocketpaw.service /etc/systemd/system/
sudo systemctl enable pocketpaw
sudo systemctl start pocketpaw

Or use Docker for a contained setup:

Terminal window
git clone https://github.com/pocketpaw/pocketpaw.git
cd pocketpaw
cp .env.example .env  # Add your API keys
docker compose up -d

See the full deployment guide for production configurations.

Privacy and Security

Self-hosting means:

  • No data leaves your machine (unless you use a cloud LLM provider)
  • No usage tracking: PocketPaw collects zero telemetry
  • Full audit trail: every tool execution is logged locally
  • You control updates: upgrade when you want, not when a vendor decides

For maximum privacy, use Ollama with local models. Your conversations never touch the internet.

Next Steps

Add Telegram

Connect your self-hosted agent to Telegram for mobile access.

Run with Ollama

Set up free local models for completely offline operation.

Security Model

Learn about PocketPaw’s 7-layer security architecture.

Last updated: April 29, 2026
2 min read
Edit this page