SourceShift/mini-ork
SourceShift/mini-ork has 35 GitHub stars and 11 forks. GitHot measured 0 stars in 24 hours. Last checked 2026-11-15 19:28 UTC. Last push 2026-11-13.
Crecimiento de estrellas medido
- in 24h
- 0
- in 7 days
- Recopilando historial
- in 15 days
- Recopilando historial
- in 1 month
- Recopilando historial
Cambios netos en períodos que se solapan, no totales diarios. Los datos no disponibles se dejan en blanco. Las estrellas indican interés, no calidad.
Acerca de
Prove an AI-written fix actually fixes the bug. mini-ork certify reproduces the bug against your repo's own code, attacks the patch with generated invariants in a Docker sandbox, and returns PROVEN / REFUTED / UNVERIFIED with a JSON certificate. Part of a verifier-gated, multi-model agent runtime.
IAREADME.es.md
Originalmini-ork
Un sistema operativo de tareas para agentes de IA, que los obliga a demostrar su trabajo.
English | 简体中文 | 日本語 | 한국어 | Español | Português (Brasil) | Deutsch | Français | Русский | हिन्दी | Italiano | Türkçe | Bahasa Indonesia
Una ejecución de code-fix en el IDE de mini-ork: clasificar → planificar → implementar → verificar → tres lentes de revisión sobre tres familias de modelos → publicar; después, cada archivo modificado queda a la espera de un Keep o un Reject. Ejecución de ejemplo del recorrido guiado · video en calidad completa.
mini-ork convierte un objetivo en una ejecución que se planifica, se lleva a cabo y se verifica sobre una flota de modelos: clasificar → planificar → ejecutar → verificar → reflexionar → mejorar. Cada veredicto sale de lo que el código hizo realmente al ejecutarse (pruebas, comprobaciones de tipos, esquemas, ejecución en un sandbox aislado), no de la opinión de un modelo sobre su propia salida.
Esta página es la guía de instalación. Para conocer el razonamiento detrás del proyecto, consulta Por qué existe mini-ork.
Inicio rápido
macOS, Linux o WSL:
curl -fsSL https://raw.githubusercontent.com/SourceShift/mini-ork/main/install.sh | sh
El instalador:
- clona mini-ork en
~/.local/share/mini-ork(MINI_ORK_INSTALL_DIRcambia esa ruta), - crea un
.venvdentro de la copia local e instala el perfil completo de Python (CLI, sidecar web local, Crucible), - añade
mini-orka tu PATH en~/.local/bin, - ofrece el asistente de primera ejecución cuando corre en una terminal.
Desde una copia local existente, la misma instalación:
git clone --recurse-submodules https://github.com/SourceShift/mini-ork.git
cd mini-ork
make install
mini-ork version # open a new terminal if PATH changed
--recurse-submodules descarga ui/, el crate del IDE
(SourceShift/mini-ork-ui). El runtime de
Python no lo necesita; consulta docs/UI.md para compilar el IDE.
Primera ejecución: mini-ork onboard
Un solo comando lleva una máquina recién configurada a un espacio de trabajo listo para ejecutar una receta. Nunca llama a un modelo ni gasta dinero: cada paso es una comprobación o una compilación local.
cd ~/my-project
mini-ork onboard
| Paso | Qué ocurre |
|---|---|
| requisitos previos | Comprueba Python ≥ 3.11 y git; indica si sqlite3 / jq están disponibles |
| espacio de trabajo | Crea .mini-ork/ en el directorio actual (ejecuta git init si hace falta) |
| carriles de proveedor | Informa si hay credenciales guardadas o indica el comando que las añade |
| contextnest | Opcional: clona, compila y genera una configuración inicial para el servicio de memoria local |
| zed | Opcional: conecta el agente y los servidores MCP de mini-ork al settings.json de Zed |
Los componentes opcionales solo se ofrecen cuando su cadena de herramientas está instalada (cargo, zed),
y cada uno puede elegirse de forma explícita:
mini-ork onboard --with contextnest,zed # force both
mini-ork onboard --no-contextnest --no-zed # core only
mini-ork onboard --dry-run # print the plan, change nothing
mini-ork onboard -y # accept defaults (scripts, CI)
mini-ork onboard --json # machine-readable step results
mini-ork onboard --help # every flag
Códigos de salida: 0 completado (omitir componentes no es un error), 1 falló un componente seleccionado
con --strict, 2 error de uso. Una ejecución no interactiva no hace preguntas: -y acepta
todos los valores predeterminados.
ContextNest — sustrato de memoria local
Un servicio HTTP en Rust que recuerda qué decidieron las sesiones anteriores, en qué fallaron, qué verificaron
y qué entregaron. El asistente genera config/contextnest.yaml en el nivel simple; con
--secure no escribe nada y exige CN_TOKEN para que el servicio arranque.
mini-ork onboard --with contextnest # clone + cargo build --release + seed config
mini-ork cn status # tier, endpoint, reachability, latency
A mano: git clone https://github.com/SourceShift/ContextNest.git y después
make cn-serve (escucha en 127.0.0.1:28080). Requiere Rust 1.80+. Detalles:
docs/CONTEXTNEST-INTEGRATION.md.
Zed — integración con el editor
Conecta mini-ork acp (agente externo) y mini-ork mcp-context (contexto de ejecuciones,
aprendizaje y costos, de solo lectura) con Zed. Antes de cada escritura en settings.json se crea
una copia de seguridad con marca de tiempo.
mini-ork onboard --with zed # or at any time:
mini-ork zed setup
mini-ork zed status
mini-ork zed uninstall
Consulta docs/ZED.md y docs/UI.md.
Tu primer flujo de trabajo verificado
cd ~/my-project
mini-ork onboard # initialize the project
mini-ork providers configure <lane> # hidden prompt; keys never touch argv
mini-ork doctor # dependencies, environment, provider preflight
cp ~/.local/share/mini-ork/examples/01-hello-world/kickoff.md ./kickoff.md
# Check the wiring first: no model calls, no spend.
MINI_ORK_DRY_RUN=1 mini-ork run code-fix ./kickoff.md
mini-ork validate
# Then run it for real.
mini-ork run code-fix ./kickoff.md
Un kickoff indica el repositorio de destino, los archivos permitidos, el artefacto esperado y el
comando o la regla que demuestra el éxito. Los artefactos de cada ejecución se guardan en .mini-ork/runs/,
y el estado registrado, en .mini-ork/state.db. Revisa .mini-ork/config/agents.yaml para cambiar qué
carril cubre cada rol.
Demuestra una corrección con un solo comando
mini-ork certify toma un cambio y el bug que dice corregir, reproduce el bug
contra tu código, genera entradas para las que el cambio no se escribió, lo ejecuta todo en
un sandbox de Docker y devuelve un veredicto con la evidencia adjunta:
$ mini-ork certify --base base --head fix-cheat \
--issue "median([1, 2, 3, 4]) returns 3, should return 2.5"
REFUTED the fix does not generalise — only 0% of 4 invariants hold,
which is the signature of a patch that special-cases the reported input
exit code: 1
Códigos de salida: 0 PROVEN, 1 REFUTED, 2 UNVERIFIED. Prefiere abstenerse antes que adivinar,
así que la CI puede bloquear según su resultado. Necesita Docker y un carril de modelo.
Prueba bash examples/certify-demo/demo.sh.
Verificación, aprendizaje y automejora
Cuatro bucles alrededor de un mismo motor, del recorrido guiado (datos de ejemplo) · video en calidad completa.
El GIF del principio de esta página es el bucle de ejecución. A su alrededor hay tres capas más.
Una verificación que los agentes no pueden esquivar con palabrería
Cada veredicto es evidencia de ejecución. Los verificadores de una receta ejecutan una protección antimanipulación,
la suite de pruebas, una reejecución sobre la base (la prueba debe fallar con el código antiguo) y una comprobación
de adecuación por mutación. Un segundo carril de modelo escribe pruebas de especificación a ciegas a partir del
kickoff antes de que empiece el implementador, y el implementador no puede editarlas. La cadena de controles del
publicador rechaza todo lo que no haya pasado, y un modelo revisor puede vetar un resultado, pero nunca crear un aprobado.
certify aplica el mismo criterio a un único cambio y responde PROVEN, REFUTED o, cuando no puede demostrar
ni una cosa ni la otra, UNVERIFIED. En un corpus adversarial de SWE-bench, 21 de 21 veredictos
PROVEN fueron correctos, con 0 falsas finalizaciones; el método y sus límites están en
docs/RESULTS.md, y los mecanismos, en
docs/architecture/verification-stack.md.
Un aprendizaje que solo conserva lo verificado
Tras cada ejecución, las trazas se convierten en una recompensa de proceso por nodo, y toda recompensa positiva tiene que ir acompañada de evidencia del verificador. A partir de ahí, el bucle se ramifica: ventajas por carril de las que aprende el router (GRPO), gradientes textuales que el paso de reflexión destila en lecciones, y una comprobación de conflictos antes de escribir cualquier lección. Solo las lecciones verificadas llegan a un prompt, cada prompt incluye el bloque aprendido y un registro de inyecciones anota exactamente qué recibió cada nodo, de modo que el mérito vuelve a la lección que lo ganó. Hoy los gradientes y los temas verificados sí llegan a los prompts, mientras que el enrutamiento aprendido todavía decide solo una pequeña minoría de las rutas. Ciclo de vida y estado: docs/LEARNING-LOOP-LIFECYCLE.md.
Automejora, con controles
mini-ork edita mini-ork a través del mismo grafo de recetas: framework-edit (autoediciones
verificadas con pruebas de especificación a ciegas), self-improve (escaneo, lentes, síntesis, implementación,
controles), rsi-technique-review (lee la literatura y propone técnicas que implementar) y
goal-loop. Un cambio aprendido debe superar una auditoría de hackeabilidad y una auditoría del verificador, y después
un control de no regresión sobre sondas congeladas frente a un grupo de control con reejecución a ciegas; además, cada versión
promovida conserva un puntero de reversión. El bucle de aplicación que reescribe prompts sin supervisión viene
desactivado por defecto (consulta la advertencia más abajo). framework-edit es la receta más ejecutada, y
self-improve encontró e integró su propia corrección el 2026-10-23. Detalles:
docs/RECURSIVE-SELF-IMPROVE.md,
docs/SAFETY.md, docs/ECOSYSTEM.md.
Comandos habituales
| Comando | Qué hace |
|---|---|
mini-ork run <recipe> <kickoff.md> |
Ejecuta una receta de principio a fin |
mini-ork doctor |
Comprueba dependencias, entorno y verificación previa de proveedores |
mini-ork validate |
Comprobaciones estáticas previas a la ejecución, con sugerencias Fix: |
mini-ork providers status <lane> |
Muestra si hay credenciales y de dónde vienen (nunca sus valores) |
mini-ork serve |
Interfaz web local y API en 127.0.0.1:7090 |
mini-ork garden |
Detección de deriva: colisiones, huérfanos, ejecuciones obsoletas |
mini-ork recover / resume |
Recupera una ejecución fallida o interrumpida |
mini-ork mcp / vault |
Registro de servidores MCP; cadena de backends del almacén de secretos |
mini-ork zed setup / cn status |
Integración con el editor; nivel y conectividad de ContextNest |
Recetas para empezar: code-fix, docs, refactor-audit, bug-audit-cmgk,
research-synthesis, spec-driven-delivery. Consulta recipes/ y la
guía de extensión.
Actualización
Vuelve a ejecutar el instalador o, desde una copia local, ejecuta make install; puedes repetirlo sin riesgo:
reutiliza .venv, actualiza el paquete editable, repara el comando gestionado y verifica
las herramientas del sistema operativo. Después, mini-ork update aplica las migraciones de base de datos pendientes
e informa de la deriva de configuración.
Desinstalación
mini-ork zed uninstall # remove the Zed entries
mini-ork automations scheduler uninstall # only if you installed the OS tick
rm -rf ~/.local/share/mini-ork ~/.local/bin/mini-ork
El estado de cada proyecto vive en su propio .mini-ork/; bórralo allí donde quieras eliminarlo.
Tus copias del código fuente y tu historial de git nunca se tocan.
Requisitos
| SO | macOS, Linux, WSL. Windows nativo: instala Python 3.11, Git, jq, yq y SQLite con winget y luego ejecuta py -3 .\scripts\full_install.py |
| Python | 3.11 o 3.12 |
| Git | obligatorio |
| Docker | solo para la verificación en sandbox (certify, Crucible) |
| Rust 1.80+ | solo para ContextNest y el crate del IDE |
| Acceso a modelos | un carril de proveedor configurado para ejecuciones reales; las ejecuciones en seco no necesitan ninguno |
Más información
| docs/WHY.md | Por qué existe el proyecto; mediciones; lo que no pretende afirmar |
| docs/SAFETY.md | Postura ante la automodificación y los controles que la sostienen |
| docs/ARCHITECTURE.md | Diseño del sistema y diagramas de componentes |
| docs/operator | Cómo operar mini-ork: variables de entorno, resolución de problemas |
| docs/PYTHON-SDK.md | Integra mini-ork en tu propia aplicación |
| docs/RESULTS.md | Métodos y tamaños de muestra detrás de las cifras |
| ROADMAP.md | Hacia dónde va el proyecto |
[!WARNING] mini-ork incluye un bucle de aplicación capaz de reescribir sus propios prompts y flujos de trabajo y de promover el cambio sin revisión humana. Viene desactivado por defecto (tanto
MO_APPLY_ENABLEDcomoMO_AUTO_APPLYdeben valer1), y su radio de impacto, sus límites y sus mecanismos de reversión están documentados en docs/WHY.md.
Contribución y licencia
mini-ork se distribuye bajo Apache-2.0, © Amir Khakshour. Es un proyecto joven y de nivel de investigación: usa un worktree dedicado para los cambios en el framework, acompaña cada afirmación sobre el comportamiento con un verificador y ejecuta las comprobaciones específicas de la superficie que modifiques. Consulta AGENTS.md para el flujo de contribución y GOVERNANCE.md para la dirección del proyecto.