lmcoding-local 3.1.0__py3-none-any.whl

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -0,0 +1,243 @@
1
+ Metadata-Version: 2.4
2
+ Name: lmcoding-local
3
+ Version: 3.1.0
4
+ Summary: Agente de programacion local autocorrectivo para LM Studio
5
+ Requires-Python: >=3.10
6
+ Description-Content-Type: text/markdown
7
+ Requires-Dist: openai>=1.40.0
8
+ Requires-Dist: rich>=13.7.0
9
+ Requires-Dist: prompt-toolkit>=3.0.47
10
+ Requires-Dist: tomli>=2.0.1; python_version < "3.11"
11
+
12
+ # LMCoding Codex Edition 3.1
13
+
14
+ LMCoding Ultra es un agente de programación autocorrectivo para modelos locales ejecutados en LM Studio. Inspecciona el proyecto, modifica archivos, ejecuta validaciones, detecta errores introducidos durante la tarea, intenta repararlos y puede revertir automáticamente los cambios si no consigue dejar el proyecto en un estado verificable.
15
+
16
+ Es una implementación independiente en Python inspirada en el flujo de los agentes modernos de terminal. No contiene código de Codex ni garantiza resolver todos los errores posibles: algunos fallos requieren servicios externos, credenciales, hardware, datos o decisiones humanas. Su objetivo es evitar afirmaciones falsas, comprobar los cambios y recuperarse de fallos comunes.
17
+
18
+ ## Protección contra errores
19
+
20
+ - Verificación automática después de modificar código.
21
+ - Detección de proyectos Python, JavaScript/TypeScript, Rust, Go, Gradle, Maven, .NET y PHP.
22
+ - Modos de validación `quick` y `full`.
23
+ - Hasta varios ciclos automáticos de diagnóstico → corrección → nueva prueba.
24
+ - Reversión de todos los cambios de la tarea cuando las reparaciones no funcionan.
25
+ - Checkpoints atómicos por cada edición.
26
+ - Reparación de argumentos JSON malformados producidos por modelos pequeños.
27
+ - Detección y bloqueo de bucles que repiten la misma herramienta.
28
+ - Reintentos exponenciales cuando LM Studio responde con errores temporales.
29
+ - Timeout de comandos y captura unificada de salida.
30
+ - Sesiones guardadas de forma persistente.
31
+ - Modo `/doctor` para revisar el entorno y el proyecto.
32
+
33
+ ## Preparar LM Studio
34
+
35
+ 1. Abre LM Studio.
36
+ 2. Carga un modelo de programación con soporte para herramientas/function calling.
37
+ 3. Abre **Developer**.
38
+ 4. Pulsa **Start Server**.
39
+ 5. La URL predeterminada es `http://localhost:1234/v1`.
40
+
41
+ ## Instalación global en Windows: comando `llmCodex`
42
+
43
+ Haz doble clic en:
44
+
45
+ ```bat
46
+ INSTALAR-llmCodex-EN-PATH.bat
47
+ ```
48
+
49
+ El instalador crea una copia privada en `%LOCALAPPDATA%\llmCodex`, instala las dependencias y agrega `%LOCALAPPDATA%\llmCodex\bin` al `PATH` del usuario. No agrega el Python del entorno virtual completo al PATH.
50
+
51
+ Cierra y vuelve a abrir PowerShell o CMD. Después podrás ejecutar desde cualquier carpeta:
52
+
53
+ ```powershell
54
+ llmCodex -C .
55
+ llmCodex fix -C . --full-auto
56
+ llmCodex verify -C . --mode full
57
+ ```
58
+
59
+ También se instalan los alias `llmcodex` y `lmcoding`. Para eliminar la instalación global ejecuta `DESINSTALAR-llmCodex.bat`.
60
+
61
+ ## Instalación en Windows
62
+
63
+ Ejecuta:
64
+
65
+ ```bat
66
+ install-windows.bat
67
+ ```
68
+
69
+ Después abre la carpeta de tu proyecto y ejecuta LMCoding con:
70
+
71
+ ```powershell
72
+ lmcoding -C .
73
+ ```
74
+
75
+ También puedes usar `iniciar-lmcoding.bat` desde la carpeta del proyecto.
76
+
77
+ ## Corregir automáticamente un proyecto
78
+
79
+ ```powershell
80
+ llmCodex fix -C . --full-auto
81
+ ```
82
+
83
+ Con una instrucción específica:
84
+
85
+ ```powershell
86
+ llmCodex fix "corrige el error de compilación y todas las pruebas relacionadas" -C . --full-auto
87
+ ```
88
+
89
+ En Windows también se incluye:
90
+
91
+ ```bat
92
+ corregir-proyecto.bat
93
+ ```
94
+
95
+ El subcomando `fix` activa verificación completa y hasta cinco ciclos de reparación.
96
+
97
+ ## Verificar sin usar el modelo
98
+
99
+ Comprobación rápida:
100
+
101
+ ```powershell
102
+ llmCodex verify -C . --mode quick
103
+ ```
104
+
105
+ Pruebas y build cuando sean detectados:
106
+
107
+ ```powershell
108
+ llmCodex verify -C . --mode full
109
+ ```
110
+
111
+ Diagnóstico del entorno, LM Studio y proyecto:
112
+
113
+ ```powershell
114
+ llmCodex doctor -C . --mode full
115
+ ```
116
+
117
+ ## Uso interactivo
118
+
119
+ ```powershell
120
+ llmCodex -C . --full-auto
121
+ ```
122
+
123
+ Ejemplos:
124
+
125
+ ```text
126
+ Encuentra la causa de los errores y corrígelos sin eliminar pruebas.
127
+ Ejecuta el build, corrige cada fallo y vuelve a comprobarlo.
128
+ Analiza @src/app.py y arregla el bug sin cambiar la API pública.
129
+ ```
130
+
131
+ Para enviar texto multilinea usa `Esc` seguido de `Enter`.
132
+
133
+ ## Comandos internos
134
+
135
+ ```text
136
+ /help
137
+ /status
138
+ /doctor
139
+ /verify quick
140
+ /verify full
141
+ /autofix on
142
+ /autofix off
143
+ /autofix quick
144
+ /autofix full
145
+ /permissions
146
+ /model
147
+ /models
148
+ /plan on
149
+ /plan off
150
+ /review
151
+ /diff
152
+ /undo
153
+ /compact
154
+ /new
155
+ /sessions
156
+ /resume ID
157
+ /rename NOMBRE
158
+ /save
159
+ /exit
160
+ ```
161
+
162
+ También admite:
163
+
164
+ ```text
165
+ !python -m pytest
166
+ !npm run build
167
+ ```
168
+
169
+ Y archivos adjuntos al contexto:
170
+
171
+ ```text
172
+ Revisa @src/app.py y @tests/test_app.py
173
+ ```
174
+
175
+ ## Modos de permisos
176
+
177
+ ### Recomendado
178
+
179
+ ```powershell
180
+ llmCodex -C . --full-auto
181
+ ```
182
+
183
+ Permite editar el workspace y ejecutar verificaciones locales. Sigue bloqueando o preguntando por comandos peligrosos, red o rutas externas.
184
+
185
+ ### Solo lectura
186
+
187
+ ```powershell
188
+ lmcoding -C . --sandbox read-only
189
+ ```
190
+
191
+ ### Acceso completo
192
+
193
+ ```powershell
194
+ lmcoding -C . --dangerously-bypass-approvals-and-sandbox
195
+ ```
196
+
197
+ El acceso completo es peligroso. LMCoding controla permisos a nivel de aplicación, pero no crea una sandbox real del sistema operativo.
198
+
199
+ ## Opciones del autocorrector
200
+
201
+ ```text
202
+ --self-heal / --no-self-heal
203
+ --verification off|quick|full
204
+ --fix-attempts N
205
+ --rollback-on-failure / --no-rollback-on-failure
206
+ --api-retries N
207
+ ```
208
+
209
+ Ejemplo estricto:
210
+
211
+ ```powershell
212
+ lmcoding -C . --self-heal --verification full --fix-attempts 5 --rollback-on-failure
213
+ ```
214
+
215
+ ## Configuración
216
+
217
+ Global:
218
+
219
+ ```text
220
+ ~/.lmcoding/config.toml
221
+ ```
222
+
223
+ Por proyecto:
224
+
225
+ ```text
226
+ PROYECTO/.lmcoding/config.toml
227
+ ```
228
+
229
+ Consulta `config.example.toml`.
230
+
231
+ ## Pruebas de LMCoding
232
+
233
+ ```powershell
234
+ python -m unittest discover -s tests -v
235
+ ```
236
+
237
+ Las pruebas incluidas comprueban:
238
+
239
+ - argumentos de herramientas malformados;
240
+ - checkpoints y reversión;
241
+ - detección de errores de sintaxis;
242
+ - reparación automática tras una verificación fallida;
243
+ - restauración del proyecto cuando se agotan los intentos.
@@ -0,0 +1,6 @@
1
+ lmcoding.py,sha256=NOozSV_nfWNhqf4E9IWnEqRG5WVnGbv2dmUBq0MWRK0,105182
2
+ lmcoding_local-3.1.0.dist-info/METADATA,sha256=lebZMYeNUQZs5sI9GIodjM8UiIQtenuL55ci6P8ZDZ0,6084
3
+ lmcoding_local-3.1.0.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
4
+ lmcoding_local-3.1.0.dist-info/entry_points.txt,sha256=Jur-GGtw3zqRV6HPjC5gimOeikbUyZhs0kGwpgxJynA,93
5
+ lmcoding_local-3.1.0.dist-info/top_level.txt,sha256=vPqemblA1B1A8CfzWHhVO-LW33FVHv9Sfw43FKxCCCg,9
6
+ lmcoding_local-3.1.0.dist-info/RECORD,,
@@ -0,0 +1,5 @@
1
+ Wheel-Version: 1.0
2
+ Generator: setuptools (82.0.1)
3
+ Root-Is-Purelib: true
4
+ Tag: py3-none-any
5
+
@@ -0,0 +1,4 @@
1
+ [console_scripts]
2
+ llmCodex = lmcoding:main
3
+ llmcodex = lmcoding:main
4
+ lmcoding = lmcoding:main
@@ -0,0 +1 @@
1
+ lmcoding