bitHuman docs

npx add-mcp 'https://docs.bithuman.ai/docs-mcp'

Para agentes de IA

URL: https://docs.bithuman.ai/resources/agents

Todo lo que un agente de IA necesita para leer estos documentos y crear con bitHuman.

Todo en este sitio está disponible en un formato que un agente puede leer sin parsear HTML.

Crear con un agente de codificación

Pega esto en Claude Code, Cursor, Codex u otro agente de codificación, con tu proyecto abierto:

Read https://docs.bithuman.ai/llms.txt and add a bitHuman avatar to this project: <what you are
building, for example "an iPhone app where a cartoon fox answers questions">. Pick essence-2 for a
real person or expression-2 for any other character, start from the matching example in
https://gitlab.com/bithuman/sdk/bithuman-examples (its llms.txt lists them), and read my API secret
from BITHUMAN_API_SECRET. Never print it, put it on a command line or commit it.

Necesitas un secreto de API en el plan Creator o superior: regístrate, luego elige un plan. Para mejores resultados, también dale al agente el servidor MCP de documentación y la habilidad de agente a continuación.

Markdown para cada página

• Agrega .md a la URL de cualquier página: /platforms/python.md. Cada página HTML enlaza su gemela con rel="alternate".
• O solicita markdown: una solicitud con Accept: text/markdown obtiene el mismo texto en la URL propia de la página.

curl -H "Accept: text/markdown" https://docs.bithuman.ai/platforms/python

Archivos

Archivo	Qué contiene
/llms.txt	El índice: reglas para agentes, dónde se ejecuta cada modelo, datos clave, un comando por plataforma, velocidad y enlaces
/llms-full.txt	Primeros pasos, las páginas de plataformas Python, CLI, Windows, LiveKit, Pipecat y REST, y la API REST en un solo archivo
/llms/start.txt, /llms/platforms.txt, /llms/apps.txt (iOS y iPadOS, macOS, Android, Flutter, Web), /llms/deploy.txt, /llms/models.txt, /llms/build.txt, /llms/api.txt	El mismo texto, una sección a la vez
/api/openapi.yaml	La API REST como OpenAPI 3
/versions.json	La versión actual y la línea de instalación de cada artefacto
/platforms.json	Cada forma de ejecutar bitHuman, con su primer comando y documentación
/performance.json	La velocidad de cada configuración publicada (× tiempo real), con hardware, versión y fecha
/changelog.xml	Cada versión como fuente RSS, etiquetada por plataforma
Showcase	Avatares de muestra que cualquiera puede usar: slug, código de agente, modelo

MCP de documentación

La documentación también es un servidor MCP con dos herramientas de solo lectura: search encuentra páginas, y fetch devuelve una como markdown. No requiere cuenta ni clave.

Cliente	Cómo agregarlo
Claude (claude.ai, escritorio)	agrega bitHuman docs desde el Directorio de Conectores
Claude Code	claude mcp add --transport http bithuman-docs https://docs.bithuman.ai/docs-mcp
Cursor	Agregar a Cursor (abre Cursor), o agrega el JSON a continuación a ~/.cursor/mcp.json
VS Code	Agregar a VS Code (abre VS Code), o code --add-mcp '{"name":"bithuman-docs","type":"http","url":"https://docs.bithuman.ai/docs-mcp"}'
Otros clientes	un servidor remoto (Streamable HTTP) en https://docs.bithuman.ai/docs-mcp

{ "mcpServers": { "bithuman-docs": { "url": "https://docs.bithuman.ai/docs-mcp" } } }

También está en el Registro MCP oficial como ai.bithuman/docs.

Para controlar bitHuman en sí (crear agentes, renderizar videos) desde un cliente MCP, usa el servidor propio de la CLI en su lugar: servidor MCP. Para que los personajes propios de bitHuman hablen dentro de ChatGPT o Claude, agrega el servidor alojado https://mcp.bithuman.ai/mcp (cómo).

Habilidad de agente

bithuman-integrate es una habilidad que un agente carga antes de agregar un avatar a un proyecto: elige la ruta, instala, conecta audio de 16 kHz a los fotogramas y maneja el secreto de API. Guárdala como .claude/skills/bithuman-integrate/SKILL.md en un proyecto, o ~/.claude/skills/bithuman-integrate/SKILL.md para cada proyecto:

mkdir -p .claude/skills/bithuman-integrate
curl -fsSL https://docs.bithuman.ai/skills/bithuman-integrate/SKILL.md -o .claude/skills/bithuman-integrate/SKILL.md

Reglas para agentes

1. Envía model ("essence-2" o "expression-2") en cada agente que crees, y consulta hasta que status sea ready o failed.
2. El uso de API y SDK requiere el plan Creator o superior.
3. Lee el secreto de API del entorno (BITHUMAN_API_SECRET); nunca lo escribas en código ni en una línea de comandos. En un worker de LiveKit, el secreto se lee como BITHUMAN_MASTER_SECRET (el mismo secreto con otro nombre, para que el plugin nunca lo copie en la sala) y el plugin obtiene un token acuñado (LiveKit).
4. Al explicar, indica dónde se renderiza el avatar y dónde se ejecuta la conversación: el avatar se renderiza (dispositivo, navegador, servidor, nube); la conversación se ejecuta (tu stack, el cerebro de conversación local de la CLI, o los servidores de bitHuman).
5. Toma las versiones de /versions.json, la velocidad de /performance.json y los precios de GET https://api.bithuman.ai/v1/pricing (envía el encabezado api-secret; sin él, la llamada devuelve 401), no de memoria ni de una muestra anterior.

Siguiente

• Servidor MCP (la CLI) · Inicio rápido · Referencia de API