LandslideLab/Tiltmeter

¿Qué hace Tiltmeter?

Tiltmeter — Plataforma de confianza para habilidades de agentes: firmar/verificar, registro gobernado con aprobaciones y auditoría, reproducción de depuración para habilidades de agentes (Ed25519 + FastAPI + SQLite)

Descripción general

Tiltmeter proporciona un sistema robusto para gestionar la confianza en habilidades de agentes de IA. Permite a los desarrolladores firmar habilidades digitalmente usando Ed25519, verificarlas, y mantener un registro auditable de todas las operaciones. La plataforma incluye un flujo de aprobaciones gobernado, ideal para entornos donde la seguridad y la trazabilidad son críticas.

Características principales

• Firma y verificación: Usa el algoritmo Ed25519 para firmar habilidades y verificar su integridad.
• Registro gobernado: Mantiene un registro de todas las habilidades con estados de aprobación (pendiente, aprobada, rechazada).
• Auditoría completa: Cada acción queda registrada para su posterior revisión.
• Reproducción de depuración: Permite reproducir interacciones paso a paso para depurar problemas.
• API REST: Construida con FastAPI, fácil de integrar en pipelines de CI/CD.
• Almacenamiento ligero: Usa SQLite como base de datos local, sin necesidad de infraestructura externa.

Plataformas compatibles

• Claude Code
• Cursor
• Codex
• Otros agentes compatibles con habilidades firmadas

Inicio rápido

1. Clona el repositorio:

   git clone https://github.com/LandslideLab/Tiltmeter.git
   cd Tiltmeter
   

2. Instala las dependencias:

   pip install -r requirements.txt
   

3. Inicia el servidor:

   uvicorn main:app --reload
   

4. Accede a la documentación de la API en http://localhost:8000/docs.

Uso básico

Firmar una habilidad

Envía una solicitud POST a /sign con el payload de la habilidad. Recibirás una firma Ed25519.

Verificar una habilidad

Envía una solicitud POST a /verify con la habilidad y su firma. La API devolverá un resultado de verificación.

Registrar una habilidad

Envía una solicitud POST a /register con los detalles de la habilidad para iniciar el flujo de aprobación.

Obtener el estado de aprobación

Consulta el estado de una habilidad registrada mediante GET /status/{skill_id}.

Reproducción de depuración

Para depurar una interacción, usa el endpoint /replay/{session_id}. Esto reproducirá los pasos de la sesión para facilitar la identificación de errores.

Variables de entorno

• TILTMETER_DB_PATH: Ruta al archivo de base de datos SQLite (por defecto ./tiltmeter.db).
• TILTMETER_SECRET_KEY: Clave secreta para operaciones de firma (generada automáticamente si no se proporciona).
• TILTMETER_LOG_LEVEL: Nivel de registro (por defecto info).

Contribuciones

Las contribuciones son bienvenidas. Por favor, abre un issue o pull request en el repositorio de GitHub.

Licencia

Este proyecto está bajo la licencia MIT. Consulta el archivo LICENSE para más detalles.