4bis Relay Showcase

FourBis Relay

Español · [English](README.en.md)

FourBis Relay es un workspace local para trabajar con IA conversacional sobre varios repositorios. Reúne conversaciones y contexto de ejecución, y permite consultar tareas, herramientas y resultados desde un mismo espacio web.

Explora la demo estática: una interfaz simulada con datos ficticios. No se conecta a Relay, no llama a un proveedor de IA ni ejecuta herramientas. Relay es software experimental para uso local.

Proyecto de portafolio de FourBis y Jeremías Badilla, publicado bajo la licencia MIT. Consulta [LICENSE](LICENSE) para la licencia del proyecto y [THIRDPARTYNOTICES.md](THIRDPARTYNOTICES.md) para los avisos de terceros.

Qué puedes explorar

• Conversaciones persistentes y contexto de proyecto con búsqueda.
• Tareas que pueden conservar un worktree entre mensajes y asociar la validación a un commit.
• Ejecuciones opcionales de expertos organizadas en etapas de planificación, ejecución, verificación y documentación.
• Un workspace web donde se pueden mantener a la vista chats, grafos de tareas, tablas y otras herramientas.
• Herramientas locales y servidores MCP opcionales para archivos de repositorios, shell, SQL, navegador y flujos de GitHub.

Tres ejemplos concretos:

1. Revisar un cambio de repositorio: pedir a un experto que inspeccione un proyecto, mantener la tarea en su worktree y revisar la validación asociada al commit.
2. Seguir una investigación con varias etapas: mantener la conversación junto al grafo de tareas y consultar dependencias, avance y resultados.
3. Comparar trabajo de proyectos: abrir conversaciones separadas, ordenarlas en pantalla y conservar cada borrador y contexto de proyecto por separado.

Estos ejemplos describen flujos disponibles; no implican que haya proveedores configurados, servicios externos validados ni preparación para producción. Consulta la [guía del workspace](docs/UIWORKSPACE.md) y la guía de [tareas persistentes](docs/PERSISTENTTASKS.md) para conocer su comportamiento y límites.

Presentación

Vista del workspace local.

Conversaciones simultáneas con borradores independientes.

Dependencias y avance de una tarea.

Las capturas muestran una demostración con datos ficticios. No representan actividad de proveedores externos ni una instalación pública.

Inicio rápido en Windows

Requisitos: Python 3.11 o posterior y PowerShell. Windows es el único destino de instalación validado; la portabilidad a otros sistemas no está establecida.

cd C:\ruta\al\repositorio\mcp-server
python -m venv .venv
& ".\.venv\Scripts\Activate.ps1"
python -m pip install --upgrade pip
pip install -e .
.\start.ps1

En otra ventana de PowerShell:

Invoke-RestMethod http://127.0.0.1:8413/health
Start-Process http://127.0.0.1:8413/admin/

start.ps1 define defaults locales, incluido GOOGLE_REAL=0, antes de iniciar el servidor. No lee automáticamente un archivo .env. Si quieres ejecutar un experto, configura las credenciales del modelo en el catálogo Modelos de la Admin UI. El servidor puede iniciar sin proveedor de modelos, pero la ejecución del experto no podrá completarse. Los proveedores remotos opcionales reciben el contenido incluido en una ejecución.

Documentación

• [Instalación completa](docs/SETUP.md)
• [API HTTP](docs/API.md)
• [Admin UI](docs/ADMIN_UI.md)
• [Comportamiento del workspace y acceso por teclado](docs/UI_WORKSPACE.md)
• [Tareas persistentes, validación y límites](docs/PERSISTENT_TASKS.md)
• [Arquitectura](docs/ARCHITECTURE.md)
• [Evidencia de validación y límites conocidos](docs/VALIDATION.md)
• [Límites de seguridad](SECURITY.md)
• [Contribuir](CONTRIBUTING.md)

Estado y comentarios

Relay es software experimental para uso local. La instalación y validación documentadas tienen como destino Windows. Los resultados registrados usan datos ficticios y proveedores simulados; no acreditan preparación para producción, aislamiento multiusuario, integración real con proveedores ni despliegue. Lee [VALIDATION.md](docs/VALIDATION.md) y [SECURITY.md](SECURITY.md) antes de usarlo con repositorios o credenciales reales.

¿Encontraste un problema o tienes una sugerencia concreta? Abre un issue.

Atribución y licencia

FourBis · Jeremías Badilla. El proyecto se distribuye bajo la licencia MIT; los componentes de terceros conservan sus propias licencias y avisos.

Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: FourBis
• Source: FourBis/4bis.relay-showcase
• License: MIT
• Homepage: https://fourbis.github.io/4bis.relay-showcase/

Install and usage instructions live in the source repository linked above.