Skip to content

Latest commit

 

History

History
315 lines (222 loc) · 7.14 KB

linux.md

File metadata and controls

315 lines (222 loc) · 7.14 KB

Guía de Instalación Linux para Synkra AIOS

🌐 EN | PT | ES

Distribuciones Soportadas

Distribución Versión Estado
Ubuntu 20.04+ (LTS) ✅ Totalmente Soportado
Debian 11+ (Bullseye) ✅ Totalmente Soportado
Fedora 37+ ✅ Totalmente Soportado
Arch Linux Última ✅ Totalmente Soportado
Linux Mint 21+ ✅ Totalmente Soportado
Pop!_OS 22.04+ ✅ Totalmente Soportado
openSUSE Leap 15.4+ ⚠️ Probado por la Comunidad
CentOS/RHEL 9+ ⚠️ Probado por la Comunidad

Requisitos Previos

1. Node.js (v20 o superior)

Elija su método de instalación según su distribución:

Ubuntu/Debian

# Actualizar lista de paquetes
sudo apt update

# Instalar Node.js usando NodeSource
curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
sudo apt install -y nodejs

# Verificar instalación
node --version  # Debería mostrar v20.x.x
npm --version

Alternativa: Usando nvm (Recomendado para desarrollo)

# Instalar nvm
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash

# Recargar shell
source ~/.bashrc  # o ~/.zshrc

# Instalar y usar Node.js 20
nvm install 20
nvm use 20
nvm alias default 20

Fedora

# Instalar Node.js desde repos de Fedora
sudo dnf install nodejs npm

# O usando NodeSource para versión más reciente
curl -fsSL https://rpm.nodesource.com/setup_20.x | sudo bash -
sudo dnf install -y nodejs

Arch Linux

# Instalar desde repos oficiales
sudo pacman -S nodejs npm

# O usando nvm (recomendado)
yay -S nvm  # Si usa helper AUR
nvm install 20

2. Git

# Ubuntu/Debian
sudo apt install git

# Fedora
sudo dnf install git

# Arch
sudo pacman -S git

# Verificar
git --version

3. GitHub CLI

# Ubuntu/Debian
(type -p wget >/dev/null || (sudo apt update && sudo apt-get install wget -y)) \
&& sudo mkdir -p -m 755 /etc/apt/keyrings \
&& wget -qO- https://cli.github.com/packages/githubcli-archive-keyring.gpg | sudo tee /etc/apt/keyrings/githubcli-archive-keyring.gpg > /dev/null \
&& sudo chmod go+r /etc/apt/keyrings/githubcli-archive-keyring.gpg \
&& echo "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/githubcli-archive-keyring.gpg] https://cli.github.com/packages stable main" | sudo tee /etc/apt/sources.list.d/github-cli.list > /dev/null \
&& sudo apt update \
&& sudo apt install gh -y

# Fedora
sudo dnf install gh

# Arch
sudo pacman -S github-cli

# Autenticar
gh auth login

4. Build Essentials (Opcional pero Recomendado)

Algunos paquetes npm requieren compilación:

# Ubuntu/Debian
sudo apt install build-essential

# Fedora
sudo dnf groupinstall "Development Tools"

# Arch
sudo pacman -S base-devel

Instalación

Instalación Rápida

  1. Abra su terminal

  2. Navegue al directorio de su proyecto:

    cd ~/proyectos/mi-proyecto

  3. Ejecute el instalador:

    npx github:SynkraAI/aios-core install

Qué Hace el Instalador

El instalador automáticamente:

  • ✅ Detecta su distribución Linux y aplica optimizaciones
  • ✅ Crea directorios necesarios con permisos Unix apropiados (755/644)
  • ✅ Configura rutas de IDE para Linux:
    • Cursor: ~/.config/Cursor/
    • Claude: ~/.claude/
    • Windsurf: ~/.config/Windsurf/
  • ✅ Configura scripts shell con terminaciones de línea Unix (LF)
  • ✅ Respeta la especificación XDG Base Directory
  • ✅ Maneja enlaces simbólicos correctamente

Configuración Específica por IDE

Cursor

  1. Instale Cursor: Descargue desde cursor.sh

    # Método AppImage
chmod +x cursor-*.AppImage
./cursor-*.AppImage

  2. Reglas del IDE se instalan en .cursor/rules/

  3. Atajo de teclado: Ctrl+L para abrir chat

  4. Use @nombre-del-agente para activar agentes

Claude Code (CLI)

  1. Instale Claude Code:

    npm install -g @anthropic-ai/claude-code

  2. Comandos se instalan en .claude/commands/AIOS/

  3. Use /nombre-del-agente para activar agentes

Windsurf

  1. Instale desde codeium.com/windsurf
  2. Reglas se instalan en .windsurf/rules/
  3. Use @nombre-del-agente para activar agentes

Solución de Problemas

Errores de Permiso

# Corregir permisos globales de npm (método recomendado)
mkdir -p ~/.npm-global
npm config set prefix '~/.npm-global'
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bashrc
source ~/.bashrc

# Alternativa: Corregir propiedad (si usa sudo para npm)
sudo chown -R $(whoami) ~/.npm
sudo chown -R $(whoami) /usr/local/lib/node_modules

Errores EACCES

Si ve EACCES: permission denied:

# Opción 1: Usar prefijo npm (recomendado)
npm config set prefix '~/.local'
export PATH="$HOME/.local/bin:$PATH"

# Opción 2: Corregir permisos del proyecto
chmod -R u+rwX .aios-core
chmod -R u+rwX .claude

Problemas de Autenticación GitHub CLI

# Verificar estado de autenticación actual
gh auth status

# Re-autenticar si es necesario
gh auth login --web

# Para autenticación basada en SSH
gh auth login -p ssh

Problemas Específicos de WSL

Si ejecuta en Windows Subsystem for Linux:

# Asegurar que rutas Windows no interfieran
echo 'export PATH=$(echo "$PATH" | tr ":" "\n" | grep -v "^/mnt/c" | tr "\n" ":")' >> ~/.bashrc

# Corregir problemas de terminación de línea
git config --global core.autocrlf input

# Rendimiento: Mover proyecto a sistema de archivos Linux
# Use ~/proyectos en lugar de /mnt/c/proyectos

Actualización

Para actualizar una instalación existente:

# Usando npx (recomendado)
npx github:SynkraAI/aios-core install

El actualizador:

  • Detectará su instalación existente
  • Hará respaldo de personalizaciones en .aios-backup/
  • Actualizará solo archivos modificados
  • Preservará sus configuraciones

Requisitos del Sistema

Requisito Mínimo Recomendado
Kernel 4.15+ 5.10+
RAM 2GB 8GB
Espacio en Disco 500MB 2GB
Node.js 18.x 20.x LTS
npm 9.x 10.x

Próximos Pasos

  1. Configure su IDE (vea configuración específica por IDE arriba)
  2. Ejecute *help en su agente AI para ver comandos disponibles
  3. Comience con la Guía del Usuario
  4. Únase a nuestra Comunidad en Discord para ayuda

Recursos Adicionales