Upload folder using huggingface_hub

Dockerfile

@@ -0,0 +1,18 @@
+FROM python:3.13-slim
+
+RUN useradd -m -u 1000 user
+USER user
+ENV PATH="/home/user/.local/bin:$PATH"
+
+WORKDIR /app
+
+COPY --chown=user . /app
+RUN pip install --no-cache-dir --upgrade -e .
+
+ENV PYTHONPATH="/app:$PYTHONPATH"
+ENV HRMS_TOOL_SERVER_URL="http://localhost:8030"
+ENV EMAIL_TOOL_SERVER_URL="http://localhost:8040"
+ENV CALENDAR_TOOL_SERVER_URL="http://localhost:8050"
+ENV ROCKETCHAT_TOOL_SERVER_URL="http://localhost:8060"
+
+CMD ["uvicorn", "simlab_hr.server.app:app", "--host", "0.0.0.0", "--port", "7860"]

README.md

@@ -1,10 +1,157 @@
 ---
-title: Simulationlab Hr
-emoji: 🏃
-colorFrom: gray
-colorTo: yellow
+title: SimLab HR — AI Recruiting & People Management Agent Environment
+emoji: 👔
+colorFrom: blue
+colorTo: green
 sdk: docker
-pinned: false
+app_port: 7860
+short_description: "AI HR agent environment — HRMS, email, calendar, chat"
+tags:
+  - openenv
+  - hr
+  - human-resources
+  - recruiting
+  - hrms
+  - agent-evaluation
+  - simlab
+  - reinforcement-learning
+  - rl-environment
+  - ai-agent
+  - tool-use
+  - enterprise
+  - multi-tool
+  - gymnasium
+  - collinear
+pinned: true
+license: apache-2.0
 ---
 
-Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference
+# SimLab HR — AI Recruiting & People Management Agent Environment
+
+A fully-functional HR simulation for training, evaluating, and benchmarking AI recruiting and people management agents. Built on [OpenEnv](https://github.com/meta-pytorch/OpenEnv) and powered by [SimLab](https://github.com/collinear-ai/simlab).
+
+Your agent gets a task ("schedule a phone screen", "approve a leave request", "onboard a new hire") and a real workplace with an HRMS, email, calendar, and team chat. Can it get the job done?
+
+## 4 Tool Servers, 1 Environment
+
+| Server | Port | What it does |
+|---|---|---|
+| **HRMS** (Frappe) | 8030 | Employee records, leave management, attendance, payroll |
+| **Email** (MailHog) | 8040 | Send and read emails, inbox management |
+| **Calendar** (Baikal/Chronos) | 8050 | Schedule meetings, check availability, manage events |
+| **RocketChat** | 8060 | Team messaging, channels, direct messages |
+
+Agents must reason across all four systems to complete real HR workflows — just like a human would.
+
+## Quickstart
+
+```python
+from simlab_hr import HRAction
+from simlab_hr.client import HREnv
+
+client = HREnv(base_url="http://localhost:8000")
+
+with client:
+    obs = client.reset()
+    print(obs.observation.task_instruction)
+    print(obs.observation.tools_available)  # {'hrms': [...], 'email': [...], ...}
+
+    # Check leave balance in HRMS
+    result = client.step(HRAction(
+        tool_server="hrms",
+        tool_name="get_leave_balance",
+        parameters={"employee_id": "EMP-0042"}
+    ))
+
+    # Send an email notification
+    result = client.step(HRAction(
+        tool_server="email",
+        tool_name="send_email",
+        parameters={"to": "manager@company.com", "subject": "Leave approved", "body": "..."}
+    ))
+```
+
+## What's Inside
+
+**8 sample tasks** covering real HR workflows:
+
+| Difficulty | Example |
+|---|---|
+| Easy | Approve a leave request, update an employee's designation |
+| Medium | Schedule a phone screen + send confirmation, run an attendance report |
+| Hard | Multi-person panel interview scheduling, full new-hire onboarding flow |
+
+Every task requires the agent to coordinate across multiple tool servers — this is what makes it hard.
+
+## Run Locally
+
+```bash
+git clone https://github.com/collinear-ai/simlab.git
+cd simlab/envs/simlab_hr
+
+# Start all services (HRMS, Email, Calendar, RocketChat, OpenEnv wrapper)
+docker compose up
+
+# First run pulls ~10 images and takes a few minutes for HRMS to initialize
+```
+
+Or run from Hugging Face:
+
+```python
+from simlab_hr.client import HREnv
+
+client = HREnv.from_hub("collinear/simlab-hr")
+```
+
+## Unlock 14+ Tasks from the API
+
+This environment ships with 8 sample tasks. Want more?
+
+Set your Collinear API key to unlock the full task set with real HR scenarios:
+
+```bash
+export COLLINEAR_API_KEY="your-key-here"
+```
+
+Get a free API key at **[platform.collinear.ai](https://platform.collinear.ai)** (Developer Resources → API Keys).
+
+With the API key, every `reset()` pulls a fresh task from Collinear's Scenario Manager — recruiting workflows, people management scenarios, compliance tasks, and more.
+
+## Use with TRL / GRPOTrainer
+
+Compatible with Hugging Face TRL for RL fine-tuning:
+
+```python
+from simlab_hr import HRAction
+from simlab_hr.client import HREnv
+
+env = HREnv.from_hub("collinear/simlab-hr")
+with env:
+    obs = env.reset()
+    # ... your training loop
+```
+
+## More Environments
+
+SimLab includes **5 enterprise simulation scenarios** with **14 tool servers**:
+
+| Scenario | Tools |
+|---|---|
+| **Human Resources** | HRMS, email, calendar, team chat ← *you are here* |
+| **Customer Service** | Helpdesk ticketing, team chat, email |
+| **Finance** | SEC filings, market data, Google Workspace |
+| **Coding** | Sandboxed IDE, browser automation, team chat |
+| **CRM** | Contacts, deals, pipelines, activities |
+
+Install the full toolkit:
+
+```bash
+pip install simulationlab
+simlab templates list
+```
+
+Learn more: [github.com/collinear-ai/simlab](https://github.com/collinear-ai/simlab) | [docs.collinear.ai](https://docs.collinear.ai)
+
+## License
+
+Apache 2.0 — [Collinear AI](https://collinear.ai)

__init__.py

@@ -0,0 +1,5 @@
+"""SimLab HR — OpenEnv environment for training AI recruiting and people management agents."""
+
+from simlab_hr.models import HRAction, HRObservation
+
+__all__ = ["HRAction", "HRObservation"]

client.py

@@ -0,0 +1,42 @@
+"""Typed client for the SimLab HR OpenEnv environment."""
+
+from __future__ import annotations
+
+from openenv.core.client_types import StepResult
+from openenv.core.env_client import EnvClient
+from openenv.core.env_server.types import State
+
+from simlab_hr.models import HRAction, HRObservation
+
+
+class HREnv(EnvClient[HRAction, HRObservation, State]):
+    """WebSocket client for the SimLab HR environment."""
+
+    def _step_payload(self, action: HRAction) -> dict:
+        return {
+            "tool_server": action.tool_server,
+            "tool_name": action.tool_name,
+            "parameters": action.parameters,
+        }
+
+    def _parse_result(self, payload: dict) -> StepResult[HRObservation]:
+        obs_data = payload.get("observation", {})
+        obs = HRObservation(
+            result=obs_data.get("result", ""),
+            is_error=obs_data.get("is_error", False),
+            tools_available=obs_data.get("tools_available", {}),
+            task_instruction=obs_data.get("task_instruction", ""),
+            done=payload.get("done", False),
+            reward=payload.get("reward"),
+        )
+        return StepResult(
+            observation=obs,
+            reward=payload.get("reward"),
+            done=payload.get("done", False),
+        )
+
+    def _parse_state(self, payload: dict) -> State:
+        return State(
+            episode_id=payload.get("episode_id"),
+            step_count=payload.get("step_count", 0),
+        )

docker-compose.yaml

@@ -0,0 +1,173 @@
+services:
+  # --- HRMS (Frappe) ---
+  frappe-hrms-mariadb:
+    image: ghcr.io/collinear-ai/collinear/frappe-hrms-mariadb:latest
+    environment:
+      MYSQL_ROOT_PASSWORD: admin
+      MARIADB_ROOT_PASSWORD: admin
+
+  frappe-hrms-redis:
+    image: ghcr.io/collinear-ai/collinear/frappe-hrms-redis:latest
+
+  frappe-hrms:
+    image: ghcr.io/collinear-ai/collinear/frappe-hrms:latest
+    environment:
+      FRAPPE_SITE_NAME: hrms.localhost
+      FRAPPE_ADMIN_PASSWORD: admin
+      FRAPPE_DB_HOST: frappe-hrms-mariadb
+      FRAPPE_DB_PORT: "3306"
+      FRAPPE_DB_ROOT_PASSWORD: admin
+      FRAPPE_REDIS_HOST: frappe-hrms-redis
+      FRAPPE_REDIS_PORT: "6379"
+      FRAPPE_SOCKETIO_PORT: "9000"
+      FRAPPE_DEVELOPER_MODE: "1"
+      FRAPPE_ENABLE_SCHEDULER: "1"
+      FRAPPE_INSTALL_APPS: hrms,collinear_hrms_seed
+      FRAPPE_DEPENDENCY_TIMEOUT: "180"
+    depends_on:
+      frappe-hrms-mariadb:
+        condition: service_healthy
+      frappe-hrms-redis:
+        condition: service_healthy
+
+  frappe-hrms-env:
+    image: ghcr.io/collinear-ai/collinear/frappe-hrms-env:latest
+    ports:
+      - "8030:8030"
+    environment:
+      FRAPPE_BASE_URL: http://frappe-hrms:8000
+      FRAPPE_SITE_NAME: hrms.localhost
+      FRAPPE_ADMIN_USERNAME: Administrator
+      FRAPPE_ADMIN_PASSWORD: admin
+    depends_on:
+      frappe-hrms:
+        condition: service_healthy
+    healthcheck:
+      test: ["CMD-SHELL", "python3 -c \"import urllib.request; urllib.request.urlopen('http://localhost:8030/health')\""]
+      interval: 15s
+      timeout: 5s
+      retries: 120
+      start_period: 60s
+
+  # --- Email (MailHog) ---
+  mailhog:
+    image: mailhog/mailhog:v1.0.1
+    healthcheck:
+      test: ["CMD-SHELL", "wget --spider -q http://localhost:8025/api/v2/messages || exit 1"]
+      interval: 10s
+      timeout: 5s
+      retries: 6
+      start_period: 10s
+
+  email-env:
+    image: ghcr.io/collinear-ai/collinear/email-env:latest
+    ports:
+      - "8040:8040"
+    environment:
+      MAILHOG_BASE_URL: http://mailhog:8025
+      MAILHOG_SMTP_HOST: mailhog
+      MAILHOG_SMTP_PORT: "1025"
+    depends_on:
+      mailhog:
+        condition: service_healthy
+    healthcheck:
+      test: ["CMD-SHELL", "python3 -c \"import urllib.request; urllib.request.urlopen('http://localhost:8040/health')\""]
+      interval: 10s
+      timeout: 5s
+      retries: 6
+      start_period: 10s
+
+  # --- Calendar (Baikal + Chronos) ---
+  baikal:
+    image: ckulka/baikal:0.10.1-nginx
+    volumes:
+      - baikal-config:/var/www/baikal/config
+      - baikal-specific:/var/www/baikal/Specific
+    healthcheck:
+      test: ["CMD-SHELL", "curl -sf http://localhost:80/ > /dev/null || exit 1"]
+      interval: 10s
+      timeout: 5s
+      retries: 10
+      start_period: 10s
+
+  chronos-mcp:
+    image: ghcr.io/collinear-ai/collinear/chronos-mcp:latest
+    environment:
+      CALDAV_BASE_URL: http://baikal:80/dav.php
+      CALDAV_USERNAME: chronos
+      CALDAV_PASSWORD: admin
+    depends_on:
+      baikal:
+        condition: service_healthy
+
+  chronos-server:
+    image: ghcr.io/collinear-ai/collinear/chronos-server:latest
+    ports:
+      - "8050:8050"
+    environment:
+      CHRONOS_MCP_URL: http://chronos-mcp:8040/mcp
+      CALDAV_BASE_URL: http://baikal:80/dav.php
+      CALDAV_USERNAME: chronos
+      CALDAV_PASSWORD: admin
+    depends_on:
+      chronos-mcp:
+        condition: service_healthy
+    healthcheck:
+      test: ["CMD-SHELL", "python3 -c \"import urllib.request; urllib.request.urlopen('http://localhost:8050/health')\""]
+      interval: 10s
+      timeout: 5s
+      retries: 18
+      start_period: 30s
+
+  # --- RocketChat ---
+  rocketchat-mongodb:
+    image: ghcr.io/collinear-ai/collinear/rocketchat-mongodb:6-preseeded
+
+  rocketchat:
+    image: ghcr.io/collinear-ai/collinear/rocketchat:7.6.0
+    depends_on:
+      rocketchat-mongodb:
+        condition: service_healthy
+
+  rocketchat-env:
+    image: ghcr.io/collinear-ai/collinear/rocketchat-env:latest
+    ports:
+      - "8060:8060"
+    environment:
+      ROCKETCHAT_BASE_URL: http://rocketchat:3000
+    depends_on:
+      rocketchat:
+        condition: service_healthy
+    healthcheck:
+      test: ["CMD-SHELL", "python3 -c \"import urllib.request; urllib.request.urlopen('http://localhost:8060/health')\""]
+      interval: 10s
+      timeout: 5s
+      retries: 12
+      start_period: 30s
+
+  # --- OpenEnv wrapper ---
+  openenv-server:
+    build:
+      context: .
+      dockerfile: server/Dockerfile
+    ports:
+      - "8000:8000"
+    environment:
+      HRMS_TOOL_SERVER_URL: http://frappe-hrms-env:8030
+      EMAIL_TOOL_SERVER_URL: http://email-env:8040
+      CALENDAR_TOOL_SERVER_URL: http://chronos-server:8050
+      ROCKETCHAT_TOOL_SERVER_URL: http://rocketchat-env:8060
+      COLLINEAR_API_KEY: ${COLLINEAR_API_KEY:-}
+    depends_on:
+      frappe-hrms-env:
+        condition: service_healthy
+      email-env:
+        condition: service_healthy
+      chronos-server:
+        condition: service_healthy
+      rocketchat-env:
+        condition: service_healthy
+
+volumes:
+  baikal-config: {}
+  baikal-specific: {}

landing.py

@@ -0,0 +1,152 @@
+"""Root landing page HTML for the SimLab HR Space on Hugging Face."""
+
+LANDING_HTML = """<!DOCTYPE html>
+<html lang="en">
+<head>
+<meta charset="utf-8">
+<meta name="viewport" content="width=device-width, initial-scale=1">
+<title>SimLab HR — AI Recruiting & People Management Agent Environment</title>
+<link href="https://fonts.googleapis.com/css2?family=DM+Sans:wght@400;500;700&family=JetBrains+Mono:wght@400;500&display=swap" rel="stylesheet">
+<style>
+  * { margin: 0; padding: 0; box-sizing: border-box; }
+  body { font-family: 'DM Sans', sans-serif; background: #0a0e17; color: #e2e8f0; min-height: 100vh; }
+  a { color: #60a5fa; text-decoration: none; }
+  a:hover { text-decoration: underline; }
+  code { font-family: 'JetBrains Mono', monospace; background: #1e293b; padding: 2px 6px; border-radius: 4px; font-size: 0.85em; }
+  pre { font-family: 'JetBrains Mono', monospace; background: #1e293b; padding: 16px 20px; border-radius: 8px; overflow-x: auto; font-size: 0.85em; line-height: 1.6; }
+  .container { max-width: 900px; margin: 0 auto; padding: 40px 24px 60px; }
+  .badge { display: inline-block; padding: 4px 10px; border-radius: 20px; font-size: 0.75em; font-weight: 500; margin-right: 6px; }
+  .badge-green { background: #065f46; color: #6ee7b7; }
+  .badge-blue { background: #1e3a5f; color: #93c5fd; }
+  .badge-purple { background: #3b1f6e; color: #c4b5fd; }
+
+  h1 { font-size: 2em; font-weight: 700; margin: 16px 0 8px; line-height: 1.2; }
+  .subtitle { font-size: 1.1em; color: #94a3b8; margin-bottom: 32px; }
+  h2 { font-size: 1.3em; font-weight: 700; margin: 36px 0 16px; color: #f1f5f9; }
+  p { line-height: 1.7; color: #cbd5e1; margin-bottom: 12px; }
+
+  .servers { display: grid; grid-template-columns: repeat(auto-fit, minmax(190px, 1fr)); gap: 12px; margin: 20px 0 28px; }
+  .server-card { background: #1e293b; border: 1px solid #334155; border-radius: 10px; padding: 16px; }
+  .server-card h3 { font-size: 1em; font-weight: 700; margin-bottom: 4px; color: #f8fafc; }
+  .server-card p { font-size: 0.85em; color: #94a3b8; margin: 0; line-height: 1.4; }
+  .server-card .port { font-family: 'JetBrains Mono', monospace; font-size: 0.75em; color: #64748b; }
+
+  .tasks-table { width: 100%; border-collapse: collapse; margin: 12px 0 24px; }
+  .tasks-table th { text-align: left; padding: 8px 12px; font-size: 0.85em; color: #64748b; border-bottom: 1px solid #334155; }
+  .tasks-table td { padding: 8px 12px; font-size: 0.9em; border-bottom: 1px solid #1e293b; }
+
+  .cta { background: linear-gradient(135deg, #1e3a5f, #1e293b); border: 1px solid #334155; border-radius: 12px; padding: 24px; margin: 28px 0; }
+  .cta h3 { font-size: 1.1em; margin-bottom: 8px; color: #f8fafc; }
+  .cta p { margin-bottom: 12px; }
+  .cta a.btn { display: inline-block; padding: 10px 20px; background: #2563eb; color: #fff; border-radius: 8px; font-weight: 500; }
+  .cta a.btn:hover { background: #1d4ed8; text-decoration: none; }
+
+  .links { display: flex; gap: 12px; flex-wrap: wrap; margin: 20px 0; }
+  .links a { padding: 8px 16px; border: 1px solid #334155; border-radius: 8px; font-size: 0.9em; color: #93c5fd; }
+  .links a:hover { background: #1e293b; text-decoration: none; }
+
+  .footer { margin-top: 48px; padding-top: 24px; border-top: 1px solid #1e293b; color: #475569; font-size: 0.85em; }
+</style>
+</head>
+<body>
+<div class="container">
+  <div>
+    <span class="badge badge-green">OpenEnv</span>
+    <span class="badge badge-blue">4 Tool Servers</span>
+    <span class="badge badge-purple">14+ Tasks</span>
+  </div>
+
+  <h1>SimLab HR</h1>
+  <p class="subtitle">AI Recruiting &amp; People Management Agent Environment</p>
+
+  <p>
+    A fully-functional HR simulation for training, evaluating, and benchmarking AI agents.
+    Your agent gets a task &mdash; <em>"schedule a phone screen"</em>, <em>"approve a leave request"</em>,
+    <em>"onboard a new hire"</em> &mdash; and a real workplace with an HRMS, email, calendar, and team chat.
+  </p>
+
+  <div class="links">
+    <a href="/api/docs">API Docs (Swagger)</a>
+    <a href="https://github.com/collinear-ai/simlab" target="_blank">GitHub (SimLab)</a>
+    <a href="https://platform.collinear.ai" target="_blank">Get API Key</a>
+  </div>
+
+  <h2>4 Tool Servers, 1 Environment</h2>
+  <div class="servers">
+    <div class="server-card">
+      <h3>HRMS</h3>
+      <p>Employee records, leave management, attendance, payroll</p>
+      <span class="port">:8030</span>
+    </div>
+    <div class="server-card">
+      <h3>Email</h3>
+      <p>Send and read emails, inbox management</p>
+      <span class="port">:8040</span>
+    </div>
+    <div class="server-card">
+      <h3>Calendar</h3>
+      <p>Schedule meetings, check availability, manage events</p>
+      <span class="port">:8050</span>
+    </div>
+    <div class="server-card">
+      <h3>RocketChat</h3>
+      <p>Team messaging, channels, direct messages</p>
+      <span class="port">:8060</span>
+    </div>
+  </div>
+
+  <h2>Quickstart</h2>
+<pre>from simlab_hr import HRAction
+from simlab_hr.client import HREnv
+
+client = HREnv(base_url="http://localhost:8000")
+
+with client:
+    obs = client.reset()
+    print(obs.observation.task_instruction)
+
+    result = client.step(HRAction(
+        tool_server="hrms",
+        tool_name="get_leave_balance",
+        parameters={"employee_id": "EMP-0042"}
+    ))</pre>
+
+  <h2>Sample Tasks</h2>
+  <table class="tasks-table">
+    <tr><th>Difficulty</th><th>Example</th></tr>
+    <tr><td><span class="badge badge-green">Easy</span></td><td>Approve a leave request, update an employee's designation</td></tr>
+    <tr><td><span class="badge badge-blue">Medium</span></td><td>Schedule a phone screen + send confirmation, run attendance report</td></tr>
+    <tr><td><span class="badge badge-purple">Hard</span></td><td>Multi-person panel interview scheduling, full onboarding flow</td></tr>
+  </table>
+  <p>8 tasks included out of the box. Every task requires coordinating across multiple tool servers.</p>
+
+  <div class="cta">
+    <h3>Unlock 14+ Tasks from the API</h3>
+    <p>Set <code>COLLINEAR_API_KEY</code> to access the full task set with real HR scenarios &mdash; recruiting workflows, people management, compliance tasks, and more.</p>
+    <a class="btn" href="https://platform.collinear.ai" target="_blank">Get a Free API Key &rarr;</a>
+  </div>
+
+  <h2>Run Locally</h2>
+<pre>git clone https://github.com/collinear-ai/simlab.git
+cd simlab/envs/simlab_hr
+docker compose up</pre>
+
+  <h2>More Environments</h2>
+  <p>SimLab includes <strong>5 enterprise simulation scenarios</strong> with <strong>14 tool servers</strong>:</p>
+  <table class="tasks-table">
+    <tr><th>Scenario</th><th>Tools</th></tr>
+    <tr><td><strong>Human Resources</strong> &larr; you are here</td><td>HRMS, email, calendar, team chat</td></tr>
+    <tr><td>Customer Service</td><td>Helpdesk ticketing, team chat, email</td></tr>
+    <tr><td>Finance</td><td>SEC filings, market data, Google Workspace</td></tr>
+    <tr><td>Coding</td><td>Sandboxed IDE, browser automation, team chat</td></tr>
+    <tr><td>CRM</td><td>Contacts, deals, pipelines, activities</td></tr>
+  </table>
+<pre>pip install simulationlab
+simlab templates list</pre>
+
+  <div class="footer">
+    <p>Apache 2.0 &mdash; <a href="https://collinear.ai">Collinear AI</a> &middot; <a href="https://github.com/collinear-ai/simlab">GitHub</a> &middot; <a href="https://docs.collinear.ai">Docs</a></p>
+  </div>
+</div>
+</body>
+</html>"""

models.py

@@ -0,0 +1,52 @@
+"""Action and Observation models for the SimLab HR environment."""
+
+from __future__ import annotations
+
+from typing import Literal
+
+from pydantic import Field
+
+from openenv.core.env_server.types import Action, Observation
+
+TOOL_SERVERS = ("hrms", "email", "calendar", "rocketchat")
+ToolServerName = Literal["hrms", "email", "calendar", "rocketchat"]
+
+
+class HRAction(Action):
+    """An action in the HR environment — invoke a tool on one of the tool servers."""
+
+    tool_server: ToolServerName = Field(
+        ...,
+        description="Which tool server to target: 'hrms' (employee records, leave, payroll), "
+        "'email' (send/read email), 'calendar' (schedule events), or 'rocketchat' (team chat).",
+    )
+    tool_name: str = Field(
+        ...,
+        description="Name of the tool to invoke on the selected server. "
+        "Use the tools_available field from the observation to see what's available per server.",
+    )
+    parameters: dict = Field(
+        default_factory=dict,
+        description="Tool-specific parameters as a JSON object.",
+    )
+
+
+class HRObservation(Observation):
+    """Observation returned by the HR environment after each action."""
+
+    result: str = Field(
+        ...,
+        description="Result of the tool invocation, or initial environment status on reset.",
+    )
+    is_error: bool = Field(
+        default=False,
+        description="Whether the tool invocation resulted in an error.",
+    )
+    tools_available: dict[str, list[str]] = Field(
+        default_factory=dict,
+        description="Available tools grouped by server: {'hrms': [...], 'email': [...], ...}.",
+    )
+    task_instruction: str = Field(
+        default="",
+        description="The task the agent should complete in this episode.",
+    )

openenv.yaml

@@ -0,0 +1,11 @@
+name: simlab-hr
+display_name: "SimLab HR"
+description: "HR simulation environment for training AI recruiting and people management agents — HRMS, email, calendar, and team chat."
+tags:
+  - hr
+  - human-resources
+  - recruiting
+  - enterprise
+  - agent-evaluation
+  - simlab
+  - collinear

pyproject.toml

@@ -0,0 +1,28 @@
+[project]
+name = "simlab-hr"
+version = "0.1.0"
+description = "HR simulation environment for training AI recruiting and people management agents — powered by SimLab"
+readme = "README.md"
+license = { text = "Apache-2.0" }
+authors = [{ name = "Collinear AI" }]
+requires-python = ">=3.11"
+dependencies = [
+    "openenv-core>=0.2.3",
+    "pydantic>=2.0",
+    "requests>=2.28",
+]
+
+[project.urls]
+Homepage = "https://github.com/collinear-ai/simlab"
+Documentation = "https://docs.collinear.ai"
+
+[build-system]
+requires = ["setuptools>=68.0"]
+build-backend = "setuptools.build_meta"
+
+[tool.setuptools]
+packages = ["simlab_hr", "simlab_hr.server"]
+
+[tool.setuptools.package-dir]
+"simlab_hr" = "."
+"simlab_hr.server" = "server"

server/Dockerfile

@@ -0,0 +1,36 @@
+ARG BASE_IMAGE=openenv-base:latest
+FROM ${BASE_IMAGE} AS builder
+
+WORKDIR /app
+
+COPY . /app/env
+
+WORKDIR /app/env
+RUN --mount=type=cache,target=/root/.cache/uv \
+    if [ -f uv.lock ]; then \
+        uv sync --frozen --no-install-project --no-editable; \
+    else \
+        uv sync --no-install-project --no-editable; \
+    fi
+
+RUN --mount=type=cache,target=/root/.cache/uv \
+    if [ -f uv.lock ]; then \
+        uv sync --frozen --no-editable; \
+    else \
+        uv sync --no-editable; \
+    fi
+
+FROM ${BASE_IMAGE}
+
+WORKDIR /app
+
+COPY --from=builder /app/env/.venv /app/.venv
+COPY --from=builder /app/env /app/env
+
+ENV PATH="/app/.venv/bin:$PATH"
+ENV PYTHONPATH="/app/env:$PYTHONPATH"
+
+HEALTHCHECK --interval=30s --timeout=3s --start-period=5s --retries=3 \
+    CMD curl -f http://localhost:8000/health || exit 1
+
+CMD ["sh", "-c", "cd /app/env && uvicorn server.app:app --host 0.0.0.0 --port 8000"]

server/app.py

@@ -0,0 +1,31 @@
+"""FastAPI application for the SimLab HR OpenEnv environment."""
+
+from pathlib import Path
+
+from fastapi import FastAPI
+from fastapi.responses import HTMLResponse
+from openenv.core.env_server import create_app
+
+from simlab_hr.models import HRAction, HRObservation
+from simlab_hr.server.environment import HREnvironment
+
+_openenv_app = create_app(HREnvironment, HRAction, HRObservation, env_name="simlab-hr")
+
+app = FastAPI(title="SimLab HR")
+
+_landing_html = None
+_landing_path = Path(__file__).resolve().parent.parent / "landing.py"
+if _landing_path.exists():
+    _ns = {}
+    exec(compile(_landing_path.read_text(), _landing_path, "exec"), _ns)
+    _landing_html = _ns.get("LANDING_HTML")
+
+
+@app.get("/", response_class=HTMLResponse, include_in_schema=False)
+async def landing_page():
+    if _landing_html:
+        return _landing_html
+    return '<h1>SimLab HR</h1><p><a href="/api/docs">API Docs</a></p>'
+
+
+app.mount("/api", _openenv_app)

server/environment.py

@@ -0,0 +1,136 @@
+"""HR environment — wraps 4 tool servers with OpenEnv's reset/step/state contract."""
+
+from __future__ import annotations
+
+import json
+import logging
+import os
+from uuid import uuid4
+
+import requests
+from openenv.core.env_server.interfaces import Environment
+from openenv.core.env_server.types import State
+
+from simlab_hr.models import HRAction, HRObservation
+from simlab_hr.tasks import BUNDLED_TASKS, get_task
+
+logger = logging.getLogger(__name__)
+
+MAX_STEPS_PER_EPISODE = 30
+
+TOOL_SERVER_ENV_MAP = {
+    "hrms": "HRMS_TOOL_SERVER_URL",
+    "email": "EMAIL_TOOL_SERVER_URL",
+    "calendar": "CALENDAR_TOOL_SERVER_URL",
+    "rocketchat": "ROCKETCHAT_TOOL_SERVER_URL",
+}
+
+TOOL_SERVER_DEFAULTS = {
+    "hrms": "http://localhost:8030",
+    "email": "http://localhost:8040",
+    "calendar": "http://localhost:8050",
+    "rocketchat": "http://localhost:8060",
+}
+
+
+class HREnvironment(Environment):
+    """OpenEnv environment backed by SimLab's HR tool servers."""
+
+    def __init__(self) -> None:
+        self._server_urls: dict[str, str] = {}
+        for name, env_var in TOOL_SERVER_ENV_MAP.items():
+            self._server_urls[name] = os.environ.get(env_var, TOOL_SERVER_DEFAULTS[name])
+
+        self._state = State(episode_id=str(uuid4()), step_count=0)
+        self._current_task = BUNDLED_TASKS[0]
+        self._tools: dict[str, list[str]] = {}
+        self._episode_count = 0
+
+    def reset(self) -> HRObservation:
+        self._current_task = get_task(self._episode_count)
+        self._episode_count += 1
+        self._state = State(episode_id=str(uuid4()), step_count=0)
+        self._tools = self._discover_all_tools()
+
+        return HRObservation(
+            result=(
+                "HR environment ready. You have access to 4 tool servers: "
+                "hrms (employee records, leave, payroll), email (inbox), "
+                "calendar (scheduling), and rocketchat (team messaging). "
+                "Use the tools to complete the task."
+            ),
+            is_error=False,
+            tools_available=self._tools,
+            task_instruction=self._current_task.instruction,
+            done=False,
+            reward=0.0,
+        )
+
+    def step(self, action: HRAction) -> HRObservation:
+        self._state.step_count += 1
+
+        server_url = self._server_urls.get(action.tool_server)
+        if server_url is None:
+            return HRObservation(
+                result=f"Unknown tool server: '{action.tool_server}'. Use one of: hrms, email, calendar, rocketchat.",
+                is_error=True,
+                tools_available=self._tools,
+                task_instruction=self._current_task.instruction,
+                done=False,
+                reward=0.0,
+            )
+
+        payload = {"action": {"tool_name": action.tool_name, "parameters": action.parameters}}
+        try:
+            resp = requests.post(
+                f"{server_url}/step",
+                json=payload,
+                headers={"Content-Type": "application/json"},
+                timeout=30,
+            )
+            result = resp.text
+            is_error = resp.status_code != 200
+
+            try:
+                parsed = resp.json()
+                result = json.dumps(parsed, indent=2) if isinstance(parsed, (dict, list)) else str(parsed)
+            except (json.JSONDecodeError, ValueError):
+                pass
+
+        except requests.RequestException as exc:
+            result = f"Tool invocation failed on {action.tool_server}: {exc}"
+            is_error = True
+
+        done = self._state.step_count >= MAX_STEPS_PER_EPISODE
+
+        return HRObservation(
+            result=result,
+            is_error=is_error,
+            tools_available=self._tools,
+            task_instruction=self._current_task.instruction,
+            done=done,
+            reward=0.0,
+        )
+
+    @property
+    def state(self) -> State:
+        return self._state
+
+    def _discover_all_tools(self) -> dict[str, list[str]]:
+        """Fetch available tools from each tool server."""
+        all_tools: dict[str, list[str]] = {}
+        for name, url in self._server_urls.items():
+            all_tools[name] = self._discover_tools(name, url)
+        return all_tools
+
+    def _discover_tools(self, server_name: str, server_url: str) -> list[str]:
+        """Fetch tool names from a single server's GET /tools endpoint."""
+        try:
+            resp = requests.get(f"{server_url}/tools", timeout=15)
+            resp.raise_for_status()
+            data = resp.json()
+            tools = data.get("tools", []) if isinstance(data, dict) else []
+            return [t["name"] for t in tools if isinstance(t, dict) and "name" in t]
+        except Exception as exc:
+            logger.warning("Could not discover tools from %s: %s", server_name, exc)
+            return []

server/requirements.txt

@@ -0,0 +1,4 @@
+openenv-core>=0.2.3
+pydantic>=2.0
+requests>=2.28
+uvicorn>=0.30

simlab_hr.egg-info/PKG-INFO

@@ -0,0 +1,143 @@
+Metadata-Version: 2.4
+Name: simlab-hr
+Version: 0.1.0
+Summary: HR simulation environment for training AI recruiting and people management agents — powered by SimLab
+Author: Collinear AI
+License: Apache-2.0
+Project-URL: Homepage, https://github.com/collinear-ai/simlab
+Project-URL: Documentation, https://docs.collinear.ai
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+Requires-Dist: openenv-core>=0.2.3
+Requires-Dist: pydantic>=2.0
+Requires-Dist: requests>=2.28
+
+# SimLab HR — AI Recruiting & People Management Agent Environment
+
+A fully-functional HR simulation for training, evaluating, and benchmarking AI recruiting and people management agents. Built on [OpenEnv](https://github.com/meta-pytorch/OpenEnv) and powered by [SimLab](https://github.com/collinear-ai/simlab).
+
+Your agent gets a task ("schedule a phone screen", "approve a leave request", "onboard a new hire") and a real workplace with an HRMS, email, calendar, and team chat. Can it get the job done?
+
+## 4 Tool Servers, 1 Environment
+
+| Server | Port | What it does |
+|---|---|---|
+| **HRMS** (Frappe) | 8030 | Employee records, leave management, attendance, payroll |
+| **Email** (MailHog) | 8040 | Send and read emails, inbox management |
+| **Calendar** (Baikal/Chronos) | 8050 | Schedule meetings, check availability, manage events |
+| **RocketChat** | 8060 | Team messaging, channels, direct messages |
+
+Agents must reason across all four systems to complete real HR workflows — just like a human would.
+
+## Quickstart
+
+```python
+from simlab_hr import HRAction
+from simlab_hr.client import HREnv
+
+client = HREnv(base_url="http://localhost:8000")
+
+with client:
+    obs = client.reset()
+    print(obs.observation.task_instruction)
+    print(obs.observation.tools_available)  # {'hrms': [...], 'email': [...], ...}
+
+    # Check leave balance in HRMS
+    result = client.step(HRAction(
+        tool_server="hrms",
+        tool_name="get_leave_balance",
+        parameters={"employee_id": "EMP-0042"}
+    ))
+
+    # Send an email notification
+    result = client.step(HRAction(
+        tool_server="email",
+        tool_name="send_email",
+        parameters={"to": "manager@company.com", "subject": "Leave approved", "body": "..."}
+    ))
+```
+
+## What's Inside
+
+**8 sample tasks** covering real HR workflows:
+
+| Difficulty | Example |
+|---|---|
+| Easy | Approve a leave request, update an employee's designation |
+| Medium | Schedule a phone screen + send confirmation, run an attendance report |
+| Hard | Multi-person panel interview scheduling, full new-hire onboarding flow |
+
+Every task requires the agent to coordinate across multiple tool servers — this is what makes it hard.
+
+## Run Locally
+
+```bash
+git clone https://github.com/collinear-ai/simlab.git
+cd simlab/envs/simlab_hr
+
+# Start all services (HRMS, Email, Calendar, RocketChat, OpenEnv wrapper)
+docker compose up
+
+# First run pulls ~10 images and takes a few minutes for HRMS to initialize
+```
+
+Or run from Hugging Face:
+
+```python
+from simlab_hr.client import HREnv
+
+client = HREnv.from_hub("collinear/simlab-hr")
+```
+
+## Unlock 14+ Tasks from the API
+
+This environment ships with 8 sample tasks. Want more?
+
+Set your Collinear API key to unlock the full task set with real HR scenarios:
+
+```bash
+export COLLINEAR_API_KEY="your-key-here"
+```
+
+Get a free API key at **[platform.collinear.ai](https://platform.collinear.ai)** (Developer Resources → API Keys).
+
+With the API key, every `reset()` pulls a fresh task from Collinear's Scenario Manager — recruiting workflows, people management scenarios, compliance tasks, and more.
+
+## Use with TRL / GRPOTrainer
+
+Compatible with Hugging Face TRL for RL fine-tuning:
+
+```python
+from simlab_hr import HRAction
+from simlab_hr.client import HREnv
+
+env = HREnv.from_hub("collinear/simlab-hr")
+with env:
+    obs = env.reset()
+    # ... your training loop
+```
+
+## More Environments
+
+SimLab includes **5 enterprise simulation scenarios** with **14 tool servers**:
+
+| Scenario | Tools |
+|---|---|
+| **Human Resources** | HRMS, email, calendar, team chat ← *you are here* |
+| **Customer Service** | Helpdesk ticketing, team chat, email |
+| **Finance** | SEC filings, market data, Google Workspace |
+| **Coding** | Sandboxed IDE, browser automation, team chat |
+| **CRM** | Contacts, deals, pipelines, activities |
+
+Install the full toolkit:
+
+```bash
+pip install simulationlab
+simlab templates list
+```
+
+Learn more: [github.com/collinear-ai/simlab](https://github.com/collinear-ai/simlab) | [docs.collinear.ai](https://docs.collinear.ai)
+
+## License
+
+Apache 2.0 — [Collinear AI](https://collinear.ai)

simlab_hr.egg-info/SOURCES.txt

@@ -0,0 +1,14 @@
+README.md
+pyproject.toml
+./__init__.py
+./client.py
+./models.py
+./tasks.py
+server/__init__.py
+server/app.py
+server/environment.py
+simlab_hr.egg-info/PKG-INFO
+simlab_hr.egg-info/SOURCES.txt
+simlab_hr.egg-info/dependency_links.txt
+simlab_hr.egg-info/requires.txt
+simlab_hr.egg-info/top_level.txt

simlab_hr.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

simlab_hr.egg-info/requires.txt

@@ -0,0 +1,3 @@
+openenv-core>=0.2.3
+pydantic>=2.0
+requests>=2.28

simlab_hr.egg-info/top_level.txt

@@ -0,0 +1 @@
+simlab_hr

tasks.py

@@ -0,0 +1,168 @@
+"""Task source for the HR environment — bundled samples + optional API upgrade."""
+
+from __future__ import annotations
+
+import logging
+import os
+import random
+from dataclasses import dataclass
+
+logger = logging.getLogger(__name__)
+
+COLLINEAR_PLATFORM_URL = "https://platform.collinear.ai"
+SCENARIO_MANAGER_API_URL = "https://rl-gym-api.collinear.ai"
+
+
+@dataclass
+class Task:
+    """A single HR task for the agent to complete."""
+
+    id: str
+    instruction: str
+    difficulty: str
+
+
+BUNDLED_TASKS: list[Task] = [
+    Task(
+        id="hr-001",
+        instruction=(
+            "A new candidate, Priya Mehta, has applied for the Senior Software Engineer role. "
+            "Create her employee record in the HRMS, schedule a phone screening for next "
+            "Tuesday at 2 PM on the calendar, and send her a confirmation email at "
+            "priya.mehta@gmail.com with the interview details."
+        ),
+        difficulty="medium",
+    ),
+    Task(
+        id="hr-002",
+        instruction=(
+            "Employee James Wilson (EMP-0042) has requested 5 days of annual leave starting "
+            "next Monday. Check his remaining leave balance in the HRMS, approve the request "
+            "if he has sufficient days, and notify his manager Sarah Chen via Rocket.Chat."
+        ),
+        difficulty="easy",
+    ),
+    Task(
+        id="hr-003",
+        instruction=(
+            "Run a monthly attendance report: pull the attendance records for all employees "
+            "from the HRMS for the current month, identify anyone with more than 2 absences, "
+            "and send a summary email to hr-team@company.com with the findings."
+        ),
+        difficulty="medium",
+    ),
+    Task(
+        id="hr-004",
+        instruction=(
+            "The recruiting team needs to schedule a panel interview for candidate Alex Rivera "
+            "for the Product Manager position. Check the availability of three interviewers "
+            "(Sarah Chen, Mike Johnson, Lisa Park) on the calendar for this week, find a "
+            "1-hour slot that works for all three, book the meeting, and send calendar "
+            "invites via email to all participants including the candidate at alex.rivera@email.com."
+        ),
+        difficulty="hard",
+    ),
+    Task(
+        id="hr-005",
+        instruction=(
+            "Employee Maria Santos has been promoted from Junior Developer to Senior Developer. "
+            "Update her designation and salary grade in the HRMS, send her a congratulatory "
+            "email, and post an announcement in the #general channel on Rocket.Chat."
+        ),
+        difficulty="easy",
+    ),
+    Task(
+        id="hr-006",
+        instruction=(
+            "A new employee, David Kim, is starting next Monday. Complete the onboarding "
+            "checklist: create his employee record in the HRMS with department 'Engineering', "
+            "send him a welcome email at david.kim@company.com with first-day instructions, "
+            "schedule a 30-minute orientation meeting on his start date, and add him to the "
+            "#engineering channel on Rocket.Chat."
+        ),
+        difficulty="hard",
+    ),
+    Task(
+        id="hr-007",
+        instruction=(
+            "Check how many open leave requests are pending approval in the HRMS. "
+            "List them all and send a reminder email to the respective approving managers "
+            "asking them to review the pending requests."
+        ),
+        difficulty="medium",
+    ),
+    Task(
+        id="hr-008",
+        instruction=(
+            "The quarterly performance review cycle is starting. Look up all employees "
+            "in the Engineering department from the HRMS, schedule individual 45-minute "
+            "review meetings with their manager for next week on the calendar, and "
+            "send each employee an email notification about their scheduled review time."
+        ),
+        difficulty="hard",
+    ),
+]
+
+
+def get_task(task_index: int | None = None) -> Task:
+    """Return a task — from the API if COLLINEAR_API_KEY is set, else from bundled set."""
+    api_key = os.environ.get("COLLINEAR_API_KEY", "").strip()
+
+    if api_key:
+        try:
+            return _fetch_api_task(api_key, task_index)
+        except Exception:
+            logger.warning(
+                "Failed to fetch task from Scenario Manager API, falling back to bundled tasks.",
+                exc_info=True,
+            )
+
+    if task_index is not None:
+        return BUNDLED_TASKS[task_index % len(BUNDLED_TASKS)]
+    return random.choice(BUNDLED_TASKS)
+
+
+def _fetch_api_task(api_key: str, task_index: int | None) -> Task:
+    """Fetch a task from the Collinear Scenario Manager API."""
+    import requests
+
+    base_url = os.environ.get("SIMLAB_SCENARIO_MANAGER_API_URL", SCENARIO_MANAGER_API_URL).rstrip(
+        "/"
+    )
+    headers = {"Accept": "application/json", "API-Key": api_key}
+
+    resp = requests.get(f"{base_url}/v1/scenarios", headers=headers, timeout=30)
+    resp.raise_for_status()
+    scenarios = resp.json()
+
+    hr_scenario = None
+    for s in scenarios:
+        name = (s.get("name") or "").lower().replace(" ", "-").replace("_", "-")
+        if "hr" in name or "human-resource" in name or "recruiting" in name:
+            hr_scenario = s
+            break
+
+    if hr_scenario is None:
+        raise ValueError("No HR scenario found in Scenario Manager")
+
+    scenario_id = hr_scenario["scenario_id"]
+    resp = requests.get(
+        f"{base_url}/v1/scenarios/{scenario_id}/tasks", headers=headers, timeout=30
+    )
+    resp.raise_for_status()
+    data = resp.json()
+    tasks = data.get("tasks", [])
+
+    if not tasks:
+        raise ValueError(f"No tasks found for scenario {scenario_id}")
+
+    if task_index is not None:
+        api_task = tasks[task_index % len(tasks)]
+    else:
+        api_task = random.choice(tasks)
+
+    return Task(
+        id=api_task.get("task_id", "api-unknown"),
+        instruction=api_task.get("description", ""),
+        difficulty=api_task.get("difficulty", "unknown"),
+    )