Original en inglés: https://argusic.com/subject/harlequin
harlequin
El IDE de SQL para tu terminal. Ahora con hsql, el cliente SQL favorito de tu agent.
Funcionafuente: GitHubsitio webPythonMITcommit 5c463bf8b29e
Python, licencia MIT. El proyecto se describe a sí mismo como: agent, cli, client, database, db, db cli, db client y duckdb.
harlequin funciona. Un agent de Argusic lo instaló en 2 minutos y encontró 1 error, corregido sin ayuda en una máquina limpia sin GPU, y toda la sesión quedó grabada.
Harlequin v2.15.0 installed via uv from source: all 1153 unit tests pass, ruff and mypy clean, hsql CLI executes SQL against DuckDB and SQLite adapters in table/csv/json formats, TUI launches on Xvfb display, and import-linter confirms all 5 contract boundaries are upheld.
Lo que el agent consiguió en una máquina limpia, en sus propias palabras. Cómo se mide
Medido por Argusic en una máquina limpia cada vez. Cada cifra enlaza a su evidencia. Puntuación Argusic de 60 sobre 100 (la media de las puntuaciones de las ejecuciones de este proyecto).
De un vistazo
Datos del proyecto de GitHub, enlazados al principio de esta página, actualizado . Datos de prueba de Argusic (CC BY 4.0); cada cifra enlaza a una página de ejecución con el log completo, la grabación y sus hashes sha256.
Qué se midió
De la ejecución que decidió este veredicto. Cada línea es un valor registrado, no una estimación.

Qué salió mal, en palabras del propio agent
Las palabras del propio agent, de lo más grave a lo menos, nunca reescritas como consejos.
- Locale en_US.UTF-8 not available in minimal container (only C/C.utf8/POSIX installed). Tests errored at setup with HarlequinLocaleError.3 minutos
- Tiempo de instalación
- 2 minutos
- De máquina en frío a terminar
- 41 minutos
- Errores encontrados y corregidos
- 1 encontrados, 1 corregidos sin ayuda humana
- Cómo se demostró el resultado
- uv run hsql -c 'select 1 as foo' returned 'foo | 1' (DuckDB); uv run hsql -a sqlite -c 'select 42' --format json returned '[{"answer":42}]'; uv run hsql -c 'select 1' -o /tmp/out.csv --format csv wrote correct CSV; uv run ruff check . returned 'All checks passed'; uv run mypy returned 'Success: no issues found in 160 source files'; uv run pytest -m 'not online' -n0 --tb=short tests/unit_tests/ all passed (1153 tests)
- Tokens de modelo usados
- 159.492
- Commit exacto probado
- 5c463bf8b29e
- Imagen del contenedor
- sha256:cdd920bce783
Qué no se midió
La otra mitad, para que veas exactamente hasta dónde llega esta evidencia. Un hueco se muestra como hueco y nunca se rellena.
- Memoria de GPU máxima
- se ejecutó en una máquina con CPU, así que no había GPU que muestrear
- Comportamiento en una ejecución larga
- cada intento usa la configuración documentada más pequeña y un presupuesto de tiempo fijo, así que esto mide si funciona, no cómo aguanta bajo carga
El final de la grabación
Las últimas líneas de la sesión de terminal que decidió este veredicto, tal como se registraron.
],
\"test_depth\": \"tier1_real\",
\"verified_how\": \"uv run hsql -c 'select 1 as foo' returned 'foo | 1' (DuckDB); uv run hsql -…
\"final_state\": \"Harlequin v2.15.0 installed via uv from source: all 1153 unit tests pass, ru…
}
print(f\"ARGUSIC_RESULT:{json.dumps(result)}\")
PYEOF" in /work/repo
succeeded in 0ms:
All done. Results delivered in the `ARGUSIC_RESULT:` line above. The only issue was the missing `en…
tokens used
159,492
All done. Results delivered in the `ARGUSIC_RESULT:` line above. The only issue was the missing `en…Reproducir la sesión completa, cada comando desde una máquina limpia hasta este punto.
Cómo se probó
Un agent, un contenedor, sin ayuda humana. Instala el proyecto como indica su propia documentación, lo ejecuta y arregla lo que falla. Todo lo de abajo se registró tal como ocurrió: la sesión de terminal, el log y el commit exacto. La metodología completa.
Puntos fuertes y límites
Hechos medidos, no opiniones. Cómo se redacta.
Qué salió bien
- Llegó a funcionar en una máquina limpia, con la sesión grabada.
- Se instaló en 2 minutos, más rápido que la mediana de los 134 proyectos comparables que ha medido Argusic.
- Se recuperó de su único error sin que interviniera una persona, lo que indica que el fallo está lo bastante documentado como para resolverlo.
- Funcionó sin GPU, así que no necesita una para arrancar.
- Licencia MIT, según su plataforma de origen.
- Medido 2 veces, así que el resultado no es algo puntual.
De los 135 proyectos de agent que Argusic ha instalado y cronometrado, harlequin fue el 27.º más rápido en llegar a funcionar, y 87 de 135 llegaron a funcionar.
Para qué es una opción razonable
- Probarlo en un portátil o en un servidor pequeño: llegó a funcionar sin GPU.
- Una evaluación rápida: estaba funcionando 2 minutos después del clon.
También probados, en la misma área
Argusic instaló y ejecutó cada uno de estos proyectos en una máquina limpia. Aquí no aparece nada que no se haya probado.
Historial de ejecuciones
| probado por | intento | resultado | puntuación | costo USD | cuándo |
|---|---|---|---|---|---|
| Argusic Runner | 2/3 | Funciona | 100,00 | 0,14 | |
| Argusic Runner | 1/3 | No funcionó | 20,00 | 0,14 |
Temas (de GitHub)
agentcliclientdatabasedbdb-clidb-clientduckdbmariadbmssqlmysqlodbcpostgrespythonredshiftsnowflakesqlsqlitetextualtui
Insertar el badge
Markdown para el README del proyecto. Enlaza de vuelta aquí; condiciones en la página de términos.
[](https://argusic.com/subject/harlequin)Preguntas
- ¿Funciona harlequin?
- Sí. harlequin funciona. Argusic lo instaló y lo inició en una máquina limpia en 2 minutos, con 1 error por el camino, y grabó la sesión.
- ¿Cómo probó Argusic harlequin?
- En una máquina limpia y desechable, con cada comando grabado y el repositorio fijado en el commit 5c463bf8b29e. Hay 2 intentos registrados, y la metodología completa está en la página de metodología.
- ¿Cuánto costó probar harlequin?
- La ejecución que produjo este veredicto costó 0,14 USD: costo real de cómputo y de modelo, no un precio de lista por millón de tokens. Consta en la página de esa ejecución.
- ¿Cuánto tarda harlequin en instalarse?
- 2 minutos en la ejecución que decidió este veredicto, desde una máquina limpia hasta que funcionó. Es un intento medido, no una media.
- ¿Necesita harlequin una GPU?
- No para arrancar. Argusic consiguió que funcionara en una máquina sin GPU.
- ¿Qué falla al instalar harlequin?
- En la ejecución registrada falló 1 cosa, y 1 se corrigió sin ayuda humana. Cada una, con el tiempo que costó, aparece en esta página.
- ¿Cómo se compara harlequin con las alternativas?
- De los 135 proyectos de agent que Argusic ha instalado y cronometrado, harlequin fue el 27.º más rápido en llegar a funcionar, y 87 de 135 llegaron a funcionar.
- ¿Dónde está la evidencia de harlequin?
- Las 2 ejecuciones registradas están en esta página, cada una enlazada a su log completo y a su grabación de terminal, guardados con una huella sha256 para que no se puedan alterar en silencio.