Skip to content

Quick Start

Get AgentCrew running locally in under 5 minutes. All you need is Docker and Docker Compose.

Prerequisites

One-Line Install

Run this single command to download, configure, and start AgentCrew: 

curl -fsSL https://agentcrew.sh/install.sh | bash

The installer will check that Docker is available, generate secure authentication tokens (NATS, JWT, encryption key), and start the stack automatically with local authentication enabled.

Once it finishes, open http://localhost:8080 to access the AgentCrew UI.

Manual Install

If you prefer to set things up manually, follow these steps:

Step 1: Download the Compose File

Create a directory for AgentCrew and download the required files: 

mkdir -p ~/.agentcrew && cd ~/.agentcrew

# Download docker-compose.yml
curl -fsSL -o docker-compose.yml \
  https://raw.githubusercontent.com/helmcode/agent_crew_landing/main/docker-compose.yml

Step 2: Configure Environment Variables

Create a .env file with the required tokens: 

# Generate .env with secure random tokens
cat > .env <<EOF
NATS_AUTH_TOKEN=$(openssl rand -base64 24)
AUTH_PROVIDER=local
JWT_SECRET=$(openssl rand -base64 48)
SETTINGS_ENCRYPTION_KEY=$(openssl rand -base64 32)
MULTI_TENANT=false
EOF

You can also set custom ports by adding API_PORT and FRONTEND_PORT to the .env file. For a full list of options, see Configuration.

Step 3: Start AgentCrew

docker compose up -d

Step 4: Open the UI

Open your browser and navigate to: 

http://localhost:8080

Step 5: Create Your Account

The first time you access AgentCrew, you will see the registration page. Create your account by providing your name, email, password, and an organization name. The first user automatically becomes the admin of the organization.

Note: With MULTI_TENANT=false (default), only one organization can exist. Additional users must be invited by an admin from the Organization Settings page. See Authentication for details.

Step 6: Add Your Credentials

  1. Click the Settings icon (gear) in the sidebar.
  2. Enter the API key for your chosen provider. See Providers for which credential each provider requires.
  3. Click Save.
Note: Only one credential is required. If both are set, the API key takes precedence.

Create Your First Team

  1. Click New Team to open the team creation wizard.
  2. Step 1: Team Details: Give your team a name (e.g., "My Dev Team"), add a description, and optionally set a workspace path if you want agents to access local files.
  3. Step 2: Agents: Configure the leader agent with custom instructions, then add one or more worker agents. Each worker gets a name, role, and instructions. You can also attach skills to any agent in this step.
  4. Step 3: Review: Review your team configuration and click Create.

Once created, your team will start provisioning. When the status shows running, click on the team to open the chat. Type a message and the leader will coordinate with the workers to accomplish your request.

Next Steps

  • Configuration: Learn about all available environment variables and settings.
  • Skills: Extend your agents with specialized capabilities.
  • Architecture: Understand how the system works under the hood.