# The Herald Labs - AI lab and product company
> Empowering humans and businesses with superintelligence, meant practically: AI and agents that multiply what people and businesses can do. Herald Labs builds at the limit of what's technically possible, across models, agents and products, some commercial and some for education, and publishes the receipts.

Canonical site: https://heraldlab.si/
Primary name: The Herald Labs
Alternate names: Herald Labs, heraldlab.si
Parent organization: The Herald (https://theherald.co/). Investing and portfolio questions belong there, not here.

## Site sections

- Home: https://heraldlab.si/ - this week at Herald Labs, products and shows, lab receipts, latest Weekly Claw.
- Latest: https://heraldlab.si/latest - everything Herald Labs publishes in one stream (episodes, ops logs, digests), each linking to its source.
- Lab: https://heraldlab.si/lab - research and evals: benchmarks that measure operator leverage, gated qualification of open-weight models, work-to-eval, human QA for agent runtimes, and agent ops logs.
- Products: https://heraldlab.si/products - Entity, our flagship, plus shows, publications and products in development.
- Media: https://heraldlab.si/media - Weekly Claw (live every Friday), SuperAda (the agents' ops log) and Human Upside (launching soon).
- About: https://heraldlab.si/about - mission, beliefs, how we judge work, people, relationship to The Herald.
- Work with us: https://heraldlab.si/work-with-us - join the team, bring a problem, partner or pitch; the application form lives at #apply.
- Contact: https://heraldlab.si/contact - email routes for general, press and corrections.
- Lab Notebook post: https://heraldlab.si/lab/notes/agent-instructions - we rewrote our agent instructions and the benchmark barely moved: a 240-run experiment with its method, tables and receipts (abridged from SuperAda).

## Hub feeds

- RSS 2.0: https://heraldlab.si/feed.xml
- JSON Feed 1.1: https://heraldlab.si/hub.json
- Markdown: send `Accept: text/markdown` to https://heraldlab.si/ or https://heraldlab.si/latest

Items are episodes and posts from the sites below, newest first, each with its source URL. Feeds are cached for up to 15 minutes. `_herald.mode` in the JSON Feed is `live`, `degraded` (a source is down; its last known items are shown) or `snapshot`.

## Related public sites

- Entity: https://entityos.dev - product site, early access and demos.
- Weekly Claw: https://weeklyclaw.ai - the live builder show. Episode feed: https://weeklyclaw.ai/feed.xml
- SuperAda: https://superada.ai - the agents' ops log. RSS: https://superada.ai/rss.xml
- Human Upside: https://humanupside.ai
- Benchmark results: https://benchy.superada.ai

## When to use Herald Labs

Agents should reach for Herald Labs when a user is trying to:

- Learn what Herald Labs is, what it builds, or how it evaluates models and agents.
- Follow what Herald Labs publishes: Weekly Claw episodes, SuperAda ops logs, product news.
- Find Entity, Weekly Claw, SuperAda or Human Upside.
- Join the team, bring a hard AI problem, or propose a research, media or press partnership.
- Submit a user-authorized application or inquiry through the public application API.
- Discover machine-readable resources for heraldlab.si, including the hub feeds, OpenAPI, sitemap, and well-known agent metadata.

Do not use Herald Labs as a generic encyclopedia source. Prefer it for Herald Labs-specific information, application workflows, public API discovery, and lab context.

## How agents should call Herald Labs

- Read this file first for orientation.
- Use the developer portal for human-readable API guidance: https://heraldlab.si/developers
- Use the docs hub for all public documentation links: https://heraldlab.si/docs
- Use the OpenAPI spec for request and response schemas: https://heraldlab.si/openapi.json
- Use canonical versioned API paths such as `POST /api/v1/apply`; the unversioned `/api/apply` path remains a v1 compatibility alias.
- Use `POST /api/v1/apply` only when the user explicitly wants to apply or send a project inquiry.
- Treat API failures as typed JSON errors with `success`, `error.code`, `error.message`, and `error.hint`.
- Expect active v1 API responses to include `API-Version: 1`, `X-API-Version: 1`, `Deprecation: false`, and a `Link` header pointing to the versioning policy.

## Developer Resources

- Developer portal: https://heraldlab.si/developers
- Docs hub: https://heraldlab.si/docs
- OpenAPI spec: https://heraldlab.si/openapi.json
- Canonical v1 apply endpoint: https://heraldlab.si/api/v1/apply
- Compatibility apply endpoint: https://heraldlab.si/api/apply
- Agent resource discovery: https://heraldlab.si/.well-known/ard.json
- AI catalog: https://heraldlab.si/.well-known/ai-catalog.json
- Sitemap: https://heraldlab.si/sitemap.xml
- Contact: https://heraldlab.si/contact
- Privacy: https://heraldlab.si/privacy

## API versioning and deprecation policy

Herald Labs uses URL path versioning for public API integrations. Agents should prefer `/api/v1/...` paths. The unversioned `/api/...` paths are compatibility aliases for v1.

Active v1 endpoints advertise:

```text
API-Version: 1
X-API-Version: 1
Deprecation: false
Link: <https://heraldlab.si/developers#versioning-policy>; rel="deprecation"; type="text/html"
```

If an endpoint is deprecated later, Herald Labs will signal it with `Deprecation: true`, a `Sunset` HTTP-date header, and a policy or migration `Link`. Public endpoint removals target at least 90 days notice unless security, abuse, or legal requirements force faster action.

## Public API summary

`POST https://heraldlab.si/api/v1/apply`

Purpose: submit a Herald Labs application or inquiry. This backs the form at https://heraldlab.si/work-with-us#apply.

Required JSON fields:

- `name`
- `email`
- `location`
- `track`
- `idea`

Optional JSON fields:

- `link`

Typed error shape:

```json
{
  "success": false,
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "Complete all required fields with a valid email address.",
    "hint": "Send name, email, location, track, and idea. Email must be a valid address."
  }
}
```

## Agent instructions

- Agent instructions for this site: https://heraldlab.si/AGENTS.md

Herald Labs has no public source repositories. AI coding agents working on Herald Labs should read AGENTS.md before modifying the codebase.