MicroCode

Colección de herramientas de IA ultraligeras inspiradas en la filosofía de microGPT.py: un solo archivo .py, mínimas dependencias, código limpio.

🚀 Herramientas

Archivo	Descripción	Líneas
microAgent.py	Agente de coding con tool-use (leer, escribir, ejecutar, buscar)	~400
microSearch.py	Chat con búsqueda web en tiempo real, citando fuentes	~380
microNotebook.py	Cuaderno de investigación con RAG local (TF-IDF casero)	~450
microResearch.py	Sistema autónomo de experimentación de IA	~550

📋 Requisitos

• Python 3.8+
• Ollama corriendo localmente

🔧 Instalación

# 1. Instalar Ollama
curl -fsSL https://ollama.ai/install.sh | sh

# 2. Pull de un modelo (recomendado para 4GB RAM)
ollama pull qwen2.5-coder:3b
ollama pull llama3.2:3b

# 3. Iniciar Ollama
ollama serve

💡 Uso

microAgent.py — Agente de Coding

# Apuntar a un proyecto
python3 microAgent.py /ruta/a/tu/proyecto

# Comandos disponibles
/help   # ver ayuda
/map    # ver árbol del proyecto
/model  # ver o cambiar modelo
/reset  # limpiar conversación
/exit   # salir

microSearch.py — Chat con Búsqueda Web

python3 microSearch.py

# Escribe tu pregunta para buscar + responder con IA
# Prefija con '!' para responder sin buscar
# Usa /search, /history, /clear, /model, /exit

microNotebook.py — Cuaderno de Investigación

python3 microNotebook.py

# Comandos principales
/new <nombre>        # Crear cuaderno
/open <nombre>       # Abrir cuaderno
/add <archivo>       # Agregar documento
/chat <pregunta>     # Chatear con contexto RAG
/summarize           # Generar resumen

microResearch.py — Investigación Autónoma

python3 microResearch.py

# El sistema experimenta indefinidamente
# Presiona Ctrl+C para detener

🎯 Filosofía

• Un solo archivo .py — Sin módulos externos complejos
• Dependencias mínimas — Solo stdlib de Python + Ollama local
• Código limpio — Legible, sin abstracciones innecesarias
• Autónomos — Cada archivo funciona por sí mismo

📚 Documentación

• DOCUMENTACION.md — Documentación unificada de todas las herramientas
• guia_contexto.md — Guía para agregar contexto y mejorar resultados

🤝 Inspiraciones

• microGPT.py — Andrej Karpathy
• Vane — Chat con búsqueda web
• Open Notebook — Cuaderno de investigación
• autoresearch-master — Experimentación autónoma

📄 Licencia

MIT