Ailoos SDK
Guía completa de configuración y desarrollo para el SDK de Ailoos
CONFIGURACIÓN DE VS CODE PARA AILOOS
Guía completa para configurar Visual Studio Code como entorno de desarrollo profesional para el SDK de Ailoos.
---
Paso 1: INSTALACIÓN DE VS CODE
Descargar e instalar VS Code
# Descargar desde el sitio oficial
# https://code.visualstudio.com/
# Verificar instalación
code --versionInstalar desde línea de comandos (opcional)
# macOS
brew install --cask visual-studio-code
# Ubuntu/Debian
sudo snap install code --classic
# Windows (PowerShell como Admin)
winget install -e --id Microsoft.VisualStudioCode---
Paso 2: EXTENSIONES ESENCIALES
Extensiones de Python
# Instalar desde VS Code o CLI
code --install-extension ms-python.python
code --install-extension ms-python.pylance
code --install-extension ms-python.black-formatter
code --install-extension ms-python.isortExtensiones para desarrollo
# Jupyter para notebooks
code --install-extension ms-toolsai.jupyter
# Git y control de versiones
code --install-extension eamodio.gitlens
# Docker (útil para contenedores)
code --install-extension ms-azuretools.vscode-dockerExtensiones específicas de Ailoos
# YAML (para configuración)
code --install-extension redhat.vscode-yaml
# Markdown (para documentación)
code --install-extension yzhang.markdown-all-in-one
# Thunder Client (para testing APIs)
code --install-extension rangav.vscode-thunder-client---
Paso 3: CONFIGURACIÓN DEL WORKSPACE
Crear workspace de Ailoos
# Clonar el repositorio
git clone https://github.com/empoorio/ailoos.git
cd ailoos
# Abrir en VS Code
code .Configuración de settings.json
{
"python.defaultInterpreterPath": "./venv/bin/python",
"python.linting.enabled": true,
"python.linting.pylintEnabled": true,
"python.formatting.provider": "black",
"editor.formatOnSave": true,
"editor.codeActionsOnSave": {
"source.organizeImports": true
},
"jupyter.notebookFileRoot": "${workspaceFolder}",
"git.autofetch": true
}Configuración de launch.json para debugging
{
"version": "0.2.0",
"configurations": [
{
"name": "Debug Ailoos Node",
"type": "python",
"request": "launch",
"program": "${workspaceFolder}/src/ailoos/cli/main.py",
"console": "integratedTerminal",
"args": ["node", "start"]
},
{
"name": "Debug Federated Training",
"type": "python",
"request": "launch",
"program": "${workspaceFolder}/src/ailoos/cli/main.py",
"console": "integratedTerminal",
"args": ["federated", "join", "--session-id", "test_session"]
}
]
}---
Paso 4: ENTORNO VIRTUAL
Crear entorno virtual
# Crear venv
python3 -m venv venv
# Activar venv
source venv/bin/activate # macOS/Linux
# venv\Scripts\activate # Windows
# Instalar dependencias
pip install -r src/requirements.txt
pip install -e .Seleccionar interpreter en VS Code
1. Presiona `Ctrl+Shift+P` (o `Cmd+Shift+P` en Mac)
2. Busca "Python: Select Interpreter"
3. Elige el interpreter del venv
---
Paso 5: TESTING Y DEBUGGING
Ejecutar tests
# Desde VS Code terminal
python -m pytest tests/ -v
# O usando el debugger
# F5 para iniciar debuggingDebugging de nodos federados
# Configurar breakpoint en:
# - src/ailoos/federated/trainer.py
# - src/ailoos/node/physical_node.py
# Ejecutar con F5---
Paso 6: EXTENSIONES AVANZADAS
Productividad
# IntelliSense mejorado
code --install-extension visualstudioexptteam.vscodeintellicode
# Snippets personalizados
code --install-extension ms-vscode.vscode-typescript-next
# Tema recomendado
code --install-extension dracula-theme.theme-draculaHerramientas de desarrollo
# REST Client
code --install-extension humao.rest-client
# Database client
code --install-extension cweijan.vscode-mysql-client2
# SSH
code --install-extension ms-vscode-remote.remote-ssh---
Paso 7: OPTIMIZACIÓN DEL ENTORNO
Configuración de rendimiento
{
"files.exclude": {
"**/__pycache__": true,
"**/*.pyc": true,
"**/node_modules": true,
"**/.git": false
},
"search.exclude": {
"**/node_modules": true,
"**/venv": true
},
"python.analysis.exclude": [
"**/venv/**"
]
}Atajos de teclado útiles
---
Paso 8: INTEGRACIÓN CON GIT
Configurar Git en VS Code
# Configurar usuario
git config --global user.name "Tu Nombre"
git config --global user.email "tu@email.com"
# Ver cambios
# Usa la pestaña Source Control (Ctrl+Shift+G)Flujo de trabajo recomendado
1. Crear feature branch
2. Hacer commits descriptivos
3. Push y crear PR
4. Code review
5. Merge
---
SOLUCIÓN DE PROBLEMAS
Problema: Interpreter no detectado
# Verificar que venv esté activado
which python
# Reinstalar dependencias
pip install -r requirements.txt --force-reinstallProblema: Extensiones no funcionan
# Recargar VS Code
# Ctrl+Shift+P -> "Developer: Reload Window"
# Reinstalar extensión
code --uninstall-extension extension.id
code --install-extension extension.idProblema: Debugging no funciona
# Verificar launch.json
# Asegurar que el programa path sea correcto
# Verificar que no haya errores de sintaxis---
RECOMENDACIONES FINALES
Estructura de proyecto recomendada
ailoos/
├── .vscode/ # Config VS Code
├── src/ # Código fuente
├── tests/ # Tests
├── docs/ # Documentación
└── scripts/ # Scripts útilesMejores prácticas
---
¡LISTO PARA DESARROLLAR!
Tu entorno de desarrollo está configurado para contribuir al SDK de Ailoos. 🚀
Ahora puedes:
¡Bienvenido al desarrollo de IA descentralizada! 🌟