takos-git
Servicio de hosting Git independiente basado en Bun y Cloudflare Workers, que utiliza R2 como plano de datos para objetos Git. Expone interfaces Smart HTTP y MCP para clonación, fetch, push y gestión de repositorios sin necesidad de Docker.
Ficha actualizada 26 sept 2026, 23:29 · upstream 26 sept 2026, 22:56 · release v0.5.1
Qué es takos-git
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
Takos-git es un servicio de hosting Git colaborativo diseñado para funcionar como una alternativa independiente a plataformas tradicionales. Utiliza Bun como runtime principal y se integra con Cloudflare Workers para la ejecución del código. La arquitectura está construida sobre módulos OpenTofu, lo que permite un despliegue infraestructura como código en entornos Cloudflare.
El servicio implementa el protocolo Git Smart HTTP nativamente, permitiendo operaciones estándar de clonación y push sin modificaciones en los clientes existentes. Utiliza R2 como almacenamiento de objetos para los datos del plano de datos Git, almacenando objetos como loose objects content-addressed. La gestión de referencias se realiza mediante documentos JSON únicos por repositorio.
La autenticación se maneja a través de Takosumi Accounts utilizando OAuth con código y PKCE para sesiones de navegador. El sistema expone endpoints RESTful bajo /api/v1 para la gestión de repositorios, ramas y commits, además de una consola web accesible en las rutas raíz y /ui. La arquitectura es portable y no depende de contenedores Docker tradicionales.
- Clonación y fetch estándar de repositorios Git utilizando comandos nativos sin modificaciones en el cliente
- Push de código con validación de integridad y soporte para actualizaciones fast-forward en ramas normales
- Gestión de repositorios mediante API RESTful para listados, información detallada y operaciones de árbol
- Automatización de flujos de trabajo Git utilizando herramientas MCP (Model Context Protocol) para gestión de ciclo de vida
- Arquitectura basada en Bun y Cloudflare Workers sin dependencia de contenedores Docker
- Implementación nativa del protocolo Git Smart HTTP con soporte completo para operaciones estándar
- Almacenamiento escalable mediante R2 como plano de datos para objetos Git content-addressed
- Integración con Takosumi Accounts para autenticación OAuth y gestión de sesiones seguras
- Dependencia obligatoria de la plataforma Cloudflare y sus servicios asociados (Workers, R2)
- No incluye soporte nativo para Docker ni archivos de orquestación como Dockerfile o docker-compose
- Requiere configuración manual de variables de entorno y credenciales para despliegues self-hosted
- La eliminación de repositorios sigue un proceso de cuarentena de 10 minutos antes del cleanup definitivo
Perfil de infraestructura
Estimación inicial derivada del repositorio y de los servicios detectados.
Despliegue detectado
Qué señales reales de instalación hemos encontrado.
Para despliegue, utilice los scripts de Bun proporcionados en el README. Ejecute 'bun run deploy -- takos-git-worker-release' para preparar el entorno o añada '--execute' para publicar inmediatamente. Configure las variables de entorno necesarias incluyendo APP_WORKSPACE_ID, APP_CAPSULE_ID y worker_bundle_sha256. Utilice OpenTofu con los flags enable_cloudflare_resources=true y enable_cloudflare_worker_script=true. Asegúrese de proporcionar un worker_bundle_sha256 válido para garantizar la integridad del bundle.
Stack y dependencias
Componentes inferidos a partir de manifests, configuración y documentación.
Puede sustituir a
Relaciones detectadas por el análisis del repositorio y su categoría.
Experiencia real de la comunidad
Ayuda a contrastar la estimación automática con instalaciones reales.
Todavía no hay datos comunitarios para este proyecto.