Solos Labs Documentation

Build with Solos Labs

Learn how to set up workspaces, configure agents, integrate with GitHub, and use the API to automate your workflows.

Getting Started

Create your workspace, invite teammates, connect your data, and run your first task with an agent.

1. Create your first workspace

  • Create a workspace and invite teammates
  • Link a GitHub repository
  • Upload documents and standards
Continue

2. Add an agent to your project

  • Pick a template (Tech, Hiring, Docs, Project Analyst)
  • Configure data sources and permissions
  • Try your first task
Continue

3. Call the API

  • Create an API key
  • Make a chat completion
  • Stream results
Continue

Core Concepts

Context & Knowledge

Agents use project context from your repositories, uploaded documents, and workspace standards. Control access via roles and scopes.

Tools & Integrations

Extend agents with custom tools and connect GitHub, Confluence, Jira and internal APIs to automate end-to-end workflows.

Agents

Solos Labs ships templates like Tech, Hiring, Document Writer, Reviewer and Project Analyst. You can also build custom agents by composing tools and defining domain rules.

// Example: Invoke a Tech Agent task
POST /api/agents/tech/run
{
  "workspaceId": "ws_123",
  "task": "Implement pagination for /issues endpoint",
  "repo": "github.com/acme/app",
  "branch": "feature/pagination",
  "tests": true
}

Workspaces

A workspace groups agents, data sources, repositories and teammates. Use roles to control access and auditing.

  • Owner, Admin, Contributor, Viewer roles
  • GitHub repo linking and branch permissions
  • Document libraries and standards
  • Activity history and versioning

Integrations

Connect GitHub and other tools to bring your workflow into one place. Fine-tune scopes for least-privilege access.

GitHub, Jira, Confluence, Slack, Webhooks, Custom APIs

API Reference

Use the REST API to chat, run tasks, and manage workspaces.

cURL

curl -X POST https://api.soloslabs.com/v1/chat \
  -H "Authorization: Bearer $SOLOS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "workspaceId": "ws_123",
    "messages": [{"role":"user","content":"Summarize PR #42"}],
    "stream": true
  }'

JavaScript (fetch)

const res = await fetch("https://api.soloslabs.com/v1/chat", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.SOLOS_API_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    workspaceId: "ws_123",
    messages: [{ role: "user", content: "Summarize PR #42" }],
    stream: false
  })
});
const data = await res.json();
See also: Full API Index

CLI

Automate tasks locally and in CI. Authenticate with SOLOS_API_KEY.

# Install
npm i -g @soloslabs/cli

# Login (or set SOLOS_API_KEY)
solos login

# Run an agent task
solos agent run tech --task "Add unit tests for utils/date.ts" --repo .

Security

  • Encryption in transit and at rest
  • SSO/SAML (Enterprise)
  • Audit logs and role-based access control
  • Private VPC / on‑prem / hybrid deployment options

FAQ

How do I invite my team?

Go to Workspace Settings → Members → Invite. Assign roles to control access to agents and data.

What permissions does GitHub integration need?

Read and write for selected repositories. You can scope to specific branches and repositories per workspace.