Curso de IA agéntica: prepara tu portátil
Lo que hay que instalar antes de la primera sesión del curso de IA agéntica del Hackerspace Valencia: git, uv, opencode y el repo de prácticas.
En el curso de IA agéntica para socios del Hackerspace Valencia trabajamos desde el primer minuto con agentes en nuestro portátil. Para no perder la primera media hora instalando cosas, esta es la lista de lo que hay que traer listo. Son unos 15 minutos.
Si te atascas en algo, ven 30 minutos antes de la primera sesión y lo resolvemos juntos.
Qué vas a instalar
| Qué | Para qué |
|---|---|
| git | Guardar versiones y deshacer lo que haga el agente |
| uv | Python y sus dependencias. Instala Python por ti |
| opencode | El agente con el que trabajamos en el curso |
| El repo de prácticas | El proyecto sobre el que hacemos los ejercicios |
La clave de OpenRouter para usar los modelos te la doy en la sesión. No hace falta pagar nada ni crear ninguna cuenta.
Windows: primero WSL
En Windows todo el curso va dentro de WSL, un Linux (Ubuntu) integrado en Windows. Abre PowerShell como administrador y ejecuta:
wsl --install
Reinicia, abre la aplicación Ubuntu y crea tu usuario. A partir de aquí, todos los pasos van dentro de esa terminal de Ubuntu, no en PowerShell.
1. Git
Comprueba si ya lo tienes:
git --version
Si no responde:
- Mac:
xcode-select --install - Ubuntu o WSL:
sudo apt update && sudo apt install -y git
2. uv
uv gestiona Python y las dependencias del proyecto. No hace falta instalar Python aparte: uv descarga la versión que pide el proyecto. De paso, te ahorra el error de certificados (CERTIFICATE_VERIFY_FAILED) que da a veces el Python de Mac.
curl -LsSf https://astral.sh/uv/install.sh | sh
En Mac con Homebrew también vale brew install uv. Si prefieres otra vía, están todas en la documentación de uv.
3. opencode
opencode es un agente de programación abierto que funciona en la terminal y acepta cualquier modelo. Lo que aprendamos con él sirve igual para Claude Code, Codex o Cursor.
curl -fsSL https://opencode.ai/install | bash
En Mac o Linux con Homebrew: brew install anomalyco/tap/opencode.
Ahora cierra la terminal y abre una nueva. Si no, no encuentra ni uv ni opencode. Comprueba que los dos responden:
uv --version
opencode --version
4. El repo de prácticas
git clone https://github.com/IgnacioLD/taller-ia-agentica-practicas
cd taller-ia-agentica-practicas
uv sync
uv run pytest
uv sync instala Python y todas las dependencias con las versiones exactas del proyecto, así que todos tenemos lo mismo. La última línea de uv run pytest tiene que decir 2 failed, 8 passed.
Esos dos tests en rojo son a propósito: arreglarlos con un agente es el primer ejercicio. Si te sale eso, ya lo tienes todo.
Si algo falla
| Síntoma | Qué hacer |
|---|---|
command not found al usar uv u opencode |
Abre una terminal nueva |
uv sync se queda parado o da error de red |
Vuelve a intentarlo con otra conexión |
| En Windows, nada funciona como en esta guía | Comprueba que estás en la terminal de Ubuntu (WSL), no en PowerShell |
| Otra cosa | Escríbeme por el Telegram de socios o ven 30 minutos antes |
Nos vemos en la primera sesión.
Borrador con IA, edición a mano. Lo publico cuando me suena a mí.