Universal Agents¶
These docs cover user-facing setup and operation for Universal Agents: onboarding, Docker deployment, configuration, chat channels, multi-user onboarding, secure tool authentication, generated sites, and verification checks.
Start Here¶
Use this order for a first deployment:
- Follow the Quickstart for the recommended bundled Docker install.
- Choose and test a Model Provider, including xAI Grok OAuth when desired.
- Skim Agent Features to see what the agent can do.
- Read Onboarding for development and automation alternatives.
- Fill in Configuration, especially
team.envsecrets. - Read Access and approval before giving agents access to tools and folders.
- Configure one or more Channels.
- Read Multi-User Onboarding before adding additional users.
- Configure Tools and Authentication for GitHub, Google, and password managers.
What Runs¶
The agent runs these main processes:
- A
TeamArchitectagent runtime. - A gateway process for local chat and app adapters.
- Optional channel adapters for Telegram, WhatsApp, Discord, Signal, and Photon/iMessage.
- A website HTTP service for docs, skill references, and generated sites.
- An activity collector service.
- A secure tool broker, which always runs, for credentialed tool calls.
Important Boundaries¶
- User secrets belong in
team.env, Docker secrets, or broker-only env files. instance_config.yamlshould contain durable non-secret runtime settings.- Agents may request secure broker actions, but credential material stays in the broker.
- Agents work only in the person's folder, the shared
team/andagents/folders, and folders you give them; shell and Python commands run in a sandbox with the same limits. - Channel adapters share the same session model but have provider-specific setup and verification steps.
Common Local URLs¶
Default browser-facing endpoints:
| Service | Default |
|---|---|
| Installer Web UI, Web Chat, docs, skills, and generated sites | http://127.0.0.1:18090 on the host and inside the container |
| Raw Docker or development website host | derived from network.public_origin plus interactive_apps.plugins.builtin.internal_website.settings.public_port, defaulting to http://127.0.0.1:18090 |
| Secure tool broker auth links | derived from network.public_origin plus security_layer.broker_public_port, commonly http://127.0.0.1:18600 |
| Activity collector | configured by activity_collector.base_url or bind settings |