Departments Docs

Getting Started

Deploy your first autonomous department in under five minutes. This guide walks you through installation, project initialization, and your first agent deployment.

Prerequisites

  • •Node.js 20+ or Bun 1.2+
  • •An API key from an LLM provider (OpenAI, Anthropic, or local Ollama)
  • •A Cyrus 365 account (free tier includes 10,000 compute credits)

1. Install the CLI

The dep CLI is your primary interface for creating, deploying, and managing departments.

npm install -g @cyrus365/dep-cli

# Verify installation
dep --version
# => dep v4.2.7 (quantum-core 2.1.3)

2. Create a Project

Scaffold a new nexus project using the default template.

npx create-departments@latest my-nexus --template default
cd my-nexus

This creates the following structure:

my-nexus/
├── departments/
│   ├── marketing.dep.yml
│   ├── engineering.dep.yml
│   └── support.dep.yml
├── agents/
│   ├── cogniscan.yml
│   └── nexusflow.yml
├── config/
│   ├── providers.yml
│   └── routing.yml
├── .env
└── nexus.json

3. Configure Your Provider

Add your LLM provider credentials to config/providers.yml:

# config/providers.yml
providers:
  - name: primary
    type: openai
    model: gpt-4o
    max_tokens: 16384
    temperature: 0.3

  - name: fallback
    type: anthropic
    model: claude-opus-4
    max_tokens: 8192

routing:
  strategy: latency-optimized
  fallback_chain:
    - primary
    - fallback

4. Deploy Your First Agent

Activate the CogniScan Ω market intelligence agent:

dep deploy agents/cogniscan.yml

# Output:
# ✔ Validating schema... done
# ✔ Resolving dependencies... 3 deps resolved
# ✔ Spawning agent container... [cogniscan-Ω] booting
# ✔ Establishing neural link... latency 12ms
# ✔ Agent deployed successfully
#
#   ID        : agt_c7x3k9m2
#   Status    : ACTIVE
#   Endpoint  : https://api.departments.cyrus365.com/v1/agents/agt_c7x3k9m2

5. Verify Operation

Check that your agent is live and processing:

dep agents status

# Active Agents
# ┌──────────────────────┬──────────┬──────────┬───────────┐
# │ Name                 │ Status   │ Uptime   │ Throughput│
# ├──────────────────────┼──────────┼──────────┼───────────┤
# │ cogniscan-Ω          │ ACTIVE   │ 2m 14s   │ 847 ops/s │
# │ nexusflow-default    │ STANDBY  │ —        │ —         │
# └──────────────────────┴──────────┴──────────┴───────────┘

Next Steps

Your first department is live. From here you can: