mirror of
https://github.com/langbot-app/LangBot.git
synced 2026-06-21 04:54:21 +00:00
Junyan Chin
e9dd584792
* feat(api): support global API key from config.yaml (api.global_api_key) Accept a config-defined global API key anywhere a web-UI key is accepted (X-API-Key / Bearer), with no login session and no DB record. Useful for automated deployments and AI agents (HTTP API + MCP). Defaults to empty (disabled); does not require the lbk_ prefix. - templates/config.yaml: add api.global_api_key with security notes - service/apikey.py: verify_api_key checks global key first (constant-time) - docs/API_KEY_AUTH.md: document the global key + security guidance - tests: cover global-key match, prefix-free, fallback-to-db, disabled * feat(mcp): expose LangBot management as an MCP server at /mcp Add an MCP (Model Context Protocol) server so external AI agents can manage a LangBot instance. Reuses the same API-key auth as the HTTP API (including the config.yaml global API key). - pkg/api/mcp/server.py: FastMCP server wrapping the service layer; 21 curated tools across system/bots/pipelines/models/knowledge/mcp-servers/skills - pkg/api/mcp/mount.py: ASGI dispatcher fronting Quart; authenticates /mcp requests with an API key, runs the streamable-HTTP session manager lifespan - controller/main.py: serve the wrapped ASGI app via hypercorn (was run_task) - web: new 'MCP' tab in the API integration dialog showing endpoint, auth, and client config; i18n for 8 locales - tests/manual/mcp_smoke.py: e2e check (401 unauth, list tools, call tools) Tool surface is intentionally curated (not all ~25 route groups) to keep the agent surface small, safe, and maintainable. Extend deliberately. * feat(skills): add in-repo skills/ as the single source of truth Migrate the agent skills + QA/e2e test harness from the (now archived) langbot-app/langbot-skills repo into LangBot/skills/, and add four new skills. Migrated: - langbot-plugin-dev, langbot-testing (e2e), langbot-env-setup, langbot-skills-maintenance, langbot-eba-adapter-dev - the bin/lbs CLI (src/, test/, scripts/, schemas/, qa-agent-docs/) New: - langbot-dev core backend + web development - langbot-deploy Docker/K8s deployment + config.yaml + global API key - langbot-mcp-ops operating the LangBot MCP server (/mcp) - langbot-space-ops operating the Space marketplace MCP server - src/cli.ts repoRoot(): recognize the skills assets root (skills.index.json + bin/lbs) so the CLI works when nested inside the LangBot repo - README.md: unified skill catalog; skills.index.json regenerated Parity with source verified: bin/lbs validate + node test suite match the source repo (only the uncommitted .lbpkg build-artifact fixture differs). * docs(agents): document agent-facing surfaces + API/MCP/skills sync rule * docs(readme): add 'Built for AI Agents' section across all locales Highlight MCP server, in-repo skills (single source of truth), AGENTS.md sync rule, and llms.txt. Cross-link LangBot Space MCP marketplace. * style(mcp): fix ruff format + prettier lint in MCP server and API panel * style(web): prettier format MCP i18n locale entries * docs(skills): note MCP instance control in dev/testing skills All development-guidance skills now point to the LangBot instance MCP server (/mcp) and the Space marketplace MCP server, reusing API keys.
192 lines
10 KiB
Markdown
192 lines
10 KiB
Markdown
<p align="center">
|
||
<a href="https://langbot.app">
|
||
<img width="130" src="res/logo-blue.png" alt="LangBot"/>
|
||
</a>
|
||
|
||
<div align="center">
|
||
|
||
<a href="https://www.producthunt.com/products/langbot?utm_source=badge-follow&utm_medium=badge&utm_source=badge-langbot" target="_blank"><img src="https://api.producthunt.com/widgets/embed-image/v1/follow.svg?product_id=1077185&theme=light" alt="LangBot - Production-grade IM bot made easy. | Product Hunt" style="width: 250px; height: 54px;" width="250" height="54" /></a>
|
||
|
||
<h3>Plataforma de grado de producción para construir bots de mensajería instantánea con agentes de IA.</h3>
|
||
<h4>Construya, depure y despliegue bots de IA rápidamente en Slack, Discord, Telegram, WeChat y más.</h4>
|
||
|
||
[English](README.md) / [简体中文](README_CN.md) / [繁體中文](README_TW.md) / [日本語](README_JP.md) / Español / [Français](README_FR.md) / [한국어](README_KO.md) / [Русский](README_RU.md) / [Tiếng Việt](README_VI.md)
|
||
|
||
[](https://discord.gg/wdNEHETs87)
|
||
[](https://deepwiki.com/langbot-app/LangBot)
|
||
[](https://github.com/langbot-app/LangBot/releases/latest)
|
||
<img src="https://img.shields.io/badge/python-3.10 ~ 3.13 -blue.svg" alt="python">
|
||
[](https://github.com/langbot-app/LangBot/stargazers)
|
||
|
||
<a href="https://langbot.app">Inicio</a> ｜
|
||
<a href="https://link.langbot.app/en/docs/features">Características</a> ｜
|
||
<a href="https://link.langbot.app/en/docs/guide">Documentación</a> ｜
|
||
<a href="https://link.langbot.app/en/docs/api">API</a> ｜
|
||
<a href="https://space.langbot.app">Mercado de Plugins</a> ｜
|
||
<a href="https://langbot.featurebase.app/roadmap">Hoja de Ruta</a>
|
||
|
||
</div>
|
||
|
||
</p>
|
||
|
||
---
|
||
|
||
## ¿Qué es LangBot?
|
||
|
||
LangBot es una **plataforma de código abierto y grado de producción** para construir bots de mensajería instantánea impulsados por IA. Conecta modelos de lenguaje de gran escala (LLMs) con cualquier plataforma de chat, permitiéndole crear agentes inteligentes que pueden conversar, ejecutar tareas e integrarse con sus flujos de trabajo existentes.
|
||
|
||
<p align="center">
|
||
<img src="res/dashboard-overview.png" alt="Panel de gestión web de LangBot — monitoreo en tiempo real de volumen de mensajes, llamadas a modelos, tasa de éxito y sesiones activas" width="720"/>
|
||
</p>
|
||
|
||
### Capacidades Clave
|
||
|
||
- **Conversaciones e Agentes IA** — Diálogos de múltiples turnos, llamadas a herramientas, soporte multimodal, salida en streaming. RAG (base de conocimientos) incorporado con integración profunda con [Dify](https://dify.ai), [Coze](https://coze.com), [n8n](https://n8n.io), [Langflow](https://langflow.org), [Deerflow](https://deerflow.tech)、[Weknora](https://weknora.weixin.qq.com).
|
||
- **Soporte Universal de Plataformas de MI** — Un solo código base para Discord, Telegram, Slack, LINE, QQ, WeChat, WeCom, Lark, DingTalk, KOOK.
|
||
- **Listo para Producción** — Control de acceso, limitación de velocidad, filtrado de palabras sensibles, monitoreo completo y manejo de excepciones. De confianza para empresas.
|
||
- **Ecosistema de Plugins** — Cientos de plugins, arquitectura basada en eventos, extensiones de componentes y soporte del [protocolo MCP](https://modelcontextprotocol.io/).
|
||
- **Panel de Gestión Web** — Configure, gestione y monitoree sus bots a través de una interfaz de navegador intuitiva. Sin necesidad de editar YAML.
|
||
- **Arquitectura Multi-Pipeline** — Diferentes bots para diferentes escenarios, con monitoreo completo y manejo de excepciones.
|
||
|
||
[→ Conocer más sobre todas las funcionalidades](https://link.langbot.app/en/docs/features)
|
||
|
||
📍 Guías prácticas: [desplegar un bot de IA multiplataforma en 5 minutos](https://blog.langbot.app/en/blog/deploy-ai-bot-in-5-minutes/), [conectar DeepSeek a WeChat, Discord y Telegram](https://blog.langbot.app/en/blog/connect-deepseek-to-wechat/), [ejecutar un Dify Agent en Discord, Telegram y Slack](https://blog.langbot.app/en/blog/dify-agent-discord-telegram-slack/) y [crear un chatbot con n8n](https://blog.langbot.app/en/blog/n8n-multi-platform-ai-chatbot/).
|
||
|
||
---
|
||
|
||
## Inicio Rápido
|
||
|
||
### ☁️ LangBot Cloud (Recomendado)
|
||
|
||
**[LangBot Cloud](https://space.langbot.app/cloud)** — Sin despliegue, listo para usar.
|
||
|
||
### Lanzamiento en una línea
|
||
|
||
```bash
|
||
uvx langbot
|
||
```
|
||
|
||
> Requiere [uv](https://docs.astral.sh/uv/getting-started/installation/). Visite http://localhost:5300 — listo.
|
||
|
||
### Docker Compose
|
||
|
||
```bash
|
||
git clone https://github.com/langbot-app/LangBot
|
||
cd LangBot/docker
|
||
docker compose up -d
|
||
```
|
||
|
||
### Despliegue en la Nube con un Clic
|
||
|
||
[](https://zeabur.com/en-US/templates/ZKTBDH)
|
||
[](https://railway.app/template/yRrAyL?referralCode=vogKPF)
|
||
|
||
**Más opciones:** [Docker](https://link.langbot.app/en/docs/docker) · [Manual](https://link.langbot.app/en/docs/manual-deploy) · [BTPanel](https://link.langbot.app/en/docs/bt-panel) · [Kubernetes](https://docs.langbot.app/en/deploy/langbot/kubernetes)
|
||
|
||
---
|
||
|
||
## Plataformas Soportadas
|
||
|
||
| Plataforma | Estado | Notas |
|
||
|----------|--------|-------|
|
||
| Discord | ✅ | Oficial |
|
||
| Telegram | ✅ | Oficial |
|
||
| Slack | ✅ | Oficial |
|
||
| LINE | ✅ | Oficial |
|
||
| QQ | ✅ | Personal y API Oficial (Canal, DM, Grupo) |
|
||
| WeCom | ✅ | WeChat Empresarial, CS Externo, AI Bot |
|
||
| WeChat | ✅ | Personal y Cuenta Oficial |
|
||
| Lark | ✅ | Oficial |
|
||
| DingTalk | ✅ | Oficial |
|
||
| KOOK | ✅ | Oficial |
|
||
| Satori | ✅ | |
|
||
| Email | ✅ | Matrix, Satori |
|
||
| Matrix | ✅ | Admite varias plataformas puenteadas como Signal, WhatsApp, Messenger, iMessage, Mattermost, Google Chat, IRC, XMPP, Zulip y más |
|
||
|
||
---
|
||
|
||
## LLMs e Integraciones Soportadas
|
||
|
||
| Proveedor | Tipo | Estado |
|
||
|----------|------|--------|
|
||
| [OpenAI](https://platform.openai.com/) | LLM | ✅ |
|
||
| [Anthropic](https://www.anthropic.com/) | LLM | ✅ |
|
||
| [DeepSeek](https://www.deepseek.com/) | LLM | ✅ |
|
||
| [Google Gemini](https://aistudio.google.com/prompts/new_chat) | LLM | ✅ |
|
||
| [xAI](https://x.ai/) | LLM | ✅ |
|
||
| [Moonshot](https://www.moonshot.cn/) | LLM | ✅ |
|
||
| [Zhipu AI](https://open.bigmodel.cn/) | LLM | ✅ |
|
||
| [Ollama](https://ollama.com/) | LLM Local | ✅ |
|
||
| [LM Studio](https://lmstudio.ai/) | LLM Local | ✅ |
|
||
| [Dify](https://dify.ai) | LLMOps | ✅ |
|
||
| [MCP](https://modelcontextprotocol.io/) | Protocolo | ✅ |
|
||
| [SiliconFlow](https://siliconflow.cn/) | Pasarela | ✅ |
|
||
| [Aliyun Bailian](https://bailian.console.aliyun.com/) | Pasarela | ✅ |
|
||
| [Volc Engine Ark](https://console.volcengine.com/ark/region:ark+cn-beijing/model?vendor=Bytedance&view=LIST_VIEW) | Pasarela | ✅ |
|
||
| [ModelScope](https://modelscope.cn/docs/model-service/API-Inference/intro) | Pasarela | ✅ |
|
||
| [GiteeAI](https://ai.gitee.com/) | Pasarela | ✅ |
|
||
| [CompShare](https://www.compshare.cn/?ytag=GPU_YY-gh_langbot) | Plataforma GPU | ✅ |
|
||
| [PPIO](https://ppinfra.com/user/register?invited_by=QJKFYD&utm_source=github_langbot) | Plataforma GPU | ✅ |
|
||
| [ShengSuanYun](https://www.shengsuanyun.com/?from=CH_KYIPP758) | Plataforma GPU | ✅ |
|
||
| [接口 AI](https://jiekou.ai/) | Pasarela | ✅ |
|
||
| [302.AI](https://share.302.ai/SuTG99) | Pasarela | ✅ |
|
||
| [Qiniu](https://www.qiniu.com/ai/agent) | Pasarela | ✅ |
|
||
|
||
[→ Ver todas las integraciones](https://link.langbot.app/en/docs/features)
|
||
|
||
---
|
||
|
||
## ¿Por qué LangBot?
|
||
|
||
| Caso de Uso | Cómo Ayuda LangBot |
|
||
|----------|-------------------|
|
||
| **Atención al cliente** | Despliegue agentes de IA en Slack/Discord/Telegram que respondan preguntas usando su base de conocimientos |
|
||
| **Herramientas internas** | Conecte flujos de trabajo de n8n/Dify a WeCom/DingTalk para procesos empresariales automatizados |
|
||
| **Gestión de comunidades** | Modere grupos de QQ/Discord con filtrado de contenido e interacción impulsados por IA |
|
||
| **Presencia multiplataforma** | Un solo bot, todas las plataformas. Gestione desde un único panel de control |
|
||
|
||
---
|
||
|
||
## Demo en Vivo
|
||
|
||
**Pruébelo ahora:** https://demo.langbot.dev/
|
||
- Correo electrónico: `demo@langbot.app`
|
||
- Contraseña: `langbot123456`
|
||
|
||
*Nota: Entorno de demostración público. No ingrese información confidencial.*
|
||
|
||
## Diseñado para Agentes de IA 🤖
|
||
|
||
LangBot es **agent-friendly por diseño** —— tus agentes de codificación (Claude Code, Codex, Copilot, Cursor, …) pueden operar, extender y desplegar LangBot con soporte de primera clase:
|
||
|
||
- **Servidor MCP** —— LangBot expone un endpoint integrado de [Model Context Protocol](https://modelcontextprotocol.io/) en `/mcp`, replicando la API HTTP para que un agente gestione bots, pipelines, plugins y modelos de forma programática. Autentícate con la misma API key (configura una clave global en `config.yaml` o usa una clave por usuario) —— sin flujo de login. Configúralo en la pestaña **API & MCP** del panel web.
|
||
- **Skills en el repositorio** —— El directorio [`skills/`](skills/) es la **única fuente de verdad** para trabajar con LangBot: desarrollo de plugins, desarrollo del core, pruebas end-to-end, despliegue y operación de los servidores MCP de LangBot / LangBot Space. Apunta tu agente a este directorio y sabrá cómo construir.
|
||
- **AGENTS.md** —— Cada repo incluye un [`AGENTS.md`](AGENTS.md) (enlazado simbólicamente a `CLAUDE.md`) que describe la arquitectura, las convenciones y la regla de que los cambios en la API deben mantener sincronizados el servidor MCP y los skills.
|
||
- **`llms.txt`** —— El contexto del proyecto legible por máquina para LLMs está publicado en el sitio web.
|
||
|
||
> **Nube / Marketplace:** [LangBot Space](https://space.langbot.app) también expone un servidor MCP para que los agentes busquen e inspeccionen el marketplace de plugins / MCP / skills, autenticados con un Personal Access Token.
|
||
|
||
---
|
||
|
||
## Comunidad
|
||
|
||
[](https://discord.gg/wdNEHETs87)
|
||
|
||
- [Comunidad de Discord](https://discord.gg/wdNEHETs87)
|
||
|
||
---
|
||
|
||
## Historial de Stars
|
||
|
||
[](https://star-history.com/#langbot-app/LangBot&Date)
|
||
|
||
---
|
||
|
||
## Colaboradores
|
||
|
||
Gracias a todos los [colaboradores](https://github.com/langbot-app/LangBot/graphs/contributors) que han ayudado a mejorar LangBot:
|
||
|
||
<a href="https://github.com/langbot-app/LangBot/graphs/contributors">
|
||
<img src="https://contrib.rocks/image?repo=langbot-app/LangBot" />
|
||
</a>
|