solstice-agent 0.2.4

Your personal AI agent. 72 built-in tools, 21 messaging channels, voice, vision, and persistent memory. Runs locally.

Sol

The open-source AI agent that lives on your computer.

Talk to it. It reads files, uses the browser, runs commands, remembers context, and works across your apps.

No forced cloud account. Your machine. Your data. Your agent.

---

Quick Install

Windows (PowerShell):

irm https://raw.githubusercontent.com/Solasticeaistudio/solstice-agent/main/install.ps1 | iex

macOS / Linux:

curl -fsSL https://raw.githubusercontent.com/Solasticeaistudio/solstice-agent/main/install.sh | bash

Then:

sol --setup
sol

Legacy aliases still work:

solstice-agent
solstice-gateway

What It Feels Like

> Summarize this repo and tell me how it works
> Check my calendar every morning and message me the summary
> Open this API and figure out what auth it uses
> Remember that I deploy production on Fridays
> Hey Sol, what's on my screen?

Sol is not a chatbot wrapper. It is an installable agent with real tools, persistent memory, voice, scheduling, browser control, and local-first guardrails.

Why Sol

• Runs on normal computers
• Open source and MIT licensed
• Local-first by default
• Works with OpenAI, Anthropic, Gemini, or Ollama
• Uses real tools instead of pretending
• Same agent across terminal, desktop, and messaging channels

What It Can Do

Sol ships with built-in tools across files, browser, terminal, web, API discovery, voice, screen capture, recording, Docker sandboxing, scheduling, memory, and cross-channel messaging.

What that means in practice:

• Read, write, patch, and search files on your machine
• Run commands, background jobs, and inspect logs
• Search the web and open pages in a real browser
• Inspect unfamiliar APIs and map their endpoints
• Remember facts and resume conversations across sessions
• Listen for a wake word and reply by voice
• Schedule recurring work while you are away
• Respond through messaging platforms using the same memory and personality

The Main Hook

Most agent projects feel like hosted wrappers around an LLM.

Sol feels different because it lives where your work lives:

• your filesystem
• your terminal
• your browser
• your notifications
• your chats

That is the product.

Local-First by Default

Sol can run with:

• OpenAI
• Anthropic
• Gemini
• Ollama for fully local inference

Use cloud models if you want. Use local models if you want. The product is not tied to one provider or one hosted account.

# OpenAI
export OPENAI_API_KEY=sk-...
sol

# Anthropic
export ANTHROPIC_API_KEY=sk-ant-...
sol --provider anthropic

# Google Gemini
export GEMINI_API_KEY=AI...
sol --provider gemini

# Ollama (fully local)
sol --provider ollama --model llama3.1

Reach It From Anywhere

Sol can expose the same agent across messaging channels. Message it on Telegram, Discord, Slack, email, or other supported gateways and keep the same memory and personality.

Example:

export GATEWAY_TELEGRAM_ENABLED=true
export GATEWAY_TELEGRAM_BOT_TOKEN=your-token
sol-gateway

Talk to It by Voice

Say "hey Sol" and start talking. Sol can listen through your microphone, maintain a live transcript, and respond out loud. You can also switch voices, use push-to-talk, or disable voice entirely.

It Remembers

Sol stores conversation history and facts across sessions.

sol --continue

Example:

> Remember that my preferred language is Python
> What's my preferred language?
Python.

Schedule Work

Sol can run recurring tasks even when you are not actively chatting with it.

sol --cron "every day at 9am" "summarize my calendar"

You can also just ask:

> Schedule a daily summary of my GitHub notifications at 9am

Demo + Benchmarks

• Demo scripts: docs/DEMO.md
• Benchmarks: docs/BENCHMARKS.md
• One-pager: docs/ONEPAGER.md

Install Options

If you prefer the cleanest CLI install:

pipx install solstice-agent

If you prefer manual install:

pip install solstice-agent[all]

Or install only what you need:

pip install solstice-agent
pip install solstice-agent[openai]
pip install solstice-agent[voice]
pip install solstice-agent[browser]
pip install solstice-agent[gateway]
pip install solstice-agent[screen]
pip install solstice-agent[recording]
pip install solstice-agent[docker]

Browser support requires:

playwright install chromium

Security

Sol is intentionally powerful, so the safety story matters.

• Network requests are checked for SSRF and blocked from private/internal targets
• File operations are sandboxed to the workspace and sensitive paths are blocked
• Dangerous terminal commands require explicit confirmation
• Browser execution is constrained
• Docker sandbox jobs run without network and without privilege escalation
• Gateway server binds to localhost by default and uses token auth when exposed

Security validation is centralized in solstice_agent/tools/security.py for auditing.

Architecture

solstice_agent/
  agent/
    core.py
    memory.py
    scheduler.py
    router.py
    providers/
  tools/
    file_ops.py
    terminal.py
    web.py
    blackbox.py
    browser.py
    voice.py
    screen.py
    recording.py
    docker_sandbox.py
    security.py
  gateway/
    manager.py
    channels/
  cli.py
  server.py

At the center is a tool-calling loop. User message in, model decides whether to use tools, tools execute, results come back, final answer returns.

Roadmap

• Community skill marketplace
• OpenRouter provider
• MCP client support
• Agent-to-agent delegation
• Stable public API

Contributing

git clone https://github.com/Solasticeaistudio/solstice-agent
cd solstice-agent
pip install -e ".[dev,all]"
pytest

License

MIT.

Built by Solstice Studio.