Welcome to Cognithor — Roadmap & Vision

[Alex8791-cyber]

Welcome!

Cognithor is a local-first, autonomous agent operating system for personal AI assistance. All data stays on your machine — no cloud, no mandatory API keys, full GDPR compliance.

Current State (v0.22.0)

• 15 LLM Providers — Ollama, OpenAI, Anthropic, Gemini, Groq, DeepSeek, Mistral, Together, OpenRouter, xAI, Cerebras, GitHub Models, AWS Bedrock, Hugging Face, Moonshot
• 17 Communication Channels — CLI, Web UI, REST API, Telegram, Discord, Slack, WhatsApp, Signal, iMessage, Teams, Matrix, Google Chat, Mattermost, Feishu, IRC, Twitch, Voice
• 5-Tier Cognitive Memory — Core, Episodic, Semantic, Procedural, Working
• React Control Center — Full web dashboard for managing everything
• 4,746 tests passing, 89% coverage

Roadmap

Near-term

• Plugin marketplace with community contributions
• Multi-user support with role-based access
• Mobile companion app (React Native)
• Streaming responses in Control Center UI

Mid-term

• Built-in RAG pipeline for document collections
• Calendar and email integration
• Workflow builder (visual automation)
• Self-hosted cloud deployment (Kubernetes)

Long-term

• Multi-agent collaboration (agent teams)
• Federated agent networks (cross-instance A2A)
• Fine-tuning pipeline for personalized models

Get Involved

• Bug reports: Use the bug report template
• Feature ideas: Use the feature request template or post in the Ideas category
• Questions: Use the Q&A category
• Show off: Built something with Cognithor? Post in Show and Tell!

Feedback and contributions are welcome.

[Obeliscum]

Just in case somebody wants a spanish traslation of the install.sh

#!/usr/bin/env bash

============================================================================

Jarvis · Agent OS – Script de Instalación

============================================================================

Uso:

./install.sh Instalación completa (interactiva)

./install.sh --minimal Solo Core (sin Web, sin Telegram)

./install.sh --full Todo incluido (incluye Voice)

./install.sh --systemd Instalar solo servicios de Systemd

./install.sh --uninstall Desinstalación

Requisitos:

- Python 3.12+

- pip

- Ollama (instalado y en ejecución)

============================================================================

set -euo pipefail

--- Colores ---

RED='\033[0;31m'
GREEN='\033[0;32m'
YELLOW='\033[1;33m'
BLUE='\033[0;34m'
CYAN='\033[0;36m'
BOLD='\033[1m'
NC='\033[0m' # Sin color

--- Configuración ---

JARVIS_HOME="${JARVIS_HOME:-$HOME/.jarvis}"
VENV_DIR="${JARVIS_HOME}/venv"
REPO_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
MIN_PYTHON="3.12"
OLLAMA_URL="${JARVIS_OLLAMA_BASE_URL:-http://localhost:11434}"

============================================================================

Funciones auxiliares

============================================================================

info() { echo -e "${BLUE}ℹ${NC} $"; }
success() { echo -e "${GREEN}✓${NC} $"; }
warn() { echo -e "${YELLOW}⚠${NC} $"; }
error() { echo -e "${RED}✗${NC} $" >&2; }
fatal() { error "$"; exit 1; }
header() { echo -e "\n${BOLD}${CYAN}═══ $ ═══${NC}\n"; }

check_command() {
command -v "$1" &>/dev/null
}

version_ge() {
# Comprueba si la versión $1 >= $2
printf '%s\n%s\n' "$2" "$1" | sort -V | head -n1 | grep -qF "$2"
}

============================================================================

Banner

============================================================================

show_banner() {
echo -e "${BOLD}${CYAN}"
cat << 'BANNER'

    ██╗ █████╗ ██████╗ ██╗   ██╗██╗███████╗
    ██║██╔══██╗██╔══██╗██║   ██║██║██╔════╝
    ██║███████║██████╔╝██║   ██║██║███████╗

██ ██║██╔══██║██╔══██╗╚██╗ ██╔╝██║╚════██║
╚█████╔╝██║ ██║██║ ██║ ╚████╔╝ ██║███████║
╚════╝ ╚═╝ ╚═╝╚═╝ ╚═╝ ╚═══╝ ╚═╝╚══════╝
Agent OS · v0.1.0 · Instalador

BANNER
echo -e "${NC}"
}

============================================================================

Paso 1: Comprobar requisitos del sistema

============================================================================

check_prerequisites() {
header "Comprobando requisitos del sistema"
local errors=0

# Python
if check_command python3; then
    local py_version
    py_version=$(python3 -c "import sys; print(f'{sys.version_info.major}.{sys.version_info.minor}')")
    if version_ge "$py_version" "$MIN_PYTHON"; then
        success "Python $py_version encontrado"
    else
        error "Python $py_version es demasiado antiguo (se requiere al menos $MIN_PYTHON)"
        ((errors++))
    fi
else
    error "Python3 no encontrado"
    info  "Instálelo con: sudo apt install python3.12 python3.12-venv"
    ((errors++))
fi

# pip
if python3 -m pip --version &>/dev/null; then
    success "pip disponible"
else
    error "pip no encontrado"
    info  "Instálelo con: sudo apt install python3-pip"
    ((errors++))
fi

# venv
if python3 -m venv --help &>/dev/null; then
    success "Módulo venv disponible"
else
    error "venv no encontrado"
    info  "Instálelo con: sudo apt install python3.12-venv"
    ((errors++))
fi

# git (opcional)
if check_command git; then
    success "git disponible"
else
    warn "git no encontrado (opcional, recomendado para actualizaciones)"
fi

# Ollama
if check_command ollama; then
    local ollama_version
    ollama_version=$(ollama --version 2>/dev/null | head -1 || echo "desconocida")
    success "Ollama instalado ($ollama_version)"
else
    warn "Ollama no encontrado – Las funciones de LLM estarán limitadas sin Ollama"
    info "Instálelo con: curl -fsSL https://ollama.com/install.sh | sh"
fi

# ¿Servidor Ollama accesible?
if curl -sf "${OLLAMA_URL}/api/version" &>/dev/null; then
    success "Servidor Ollama accesible en (${OLLAMA_URL})"
else
    warn "Servidor Ollama no accesible en ${OLLAMA_URL}"
    info "Inícielo con: ollama serve"
fi

if [[ $errors -gt 0 ]]; then
    fatal "Faltan $errors requisito(s) críticos"
fi

}

============================================================================

Paso 2: Modelos de Ollama

============================================================================

ensure_ollama_models() {
header "Comprobando modelos de Ollama"

if ! curl -sf "${OLLAMA_URL}/api/version" &>/dev/null; then
    warn "Ollama no accesible – Descargue los modelos manualmente:"
    info "  ollama pull qwen3:8b"
    info "  ollama pull nomic-embed-text"
    info "  ollama pull qwen3:32b     (opcional, si tiene ≥24GB VRAM)"
    return 0
fi

# Consultar modelos instalados
local installed
installed=$(curl -sf "${OLLAMA_URL}/api/tags" | python3 -c "

import sys, json
data = json.load(sys.stdin)
for m in data.get('models', []):
print(m['name'])
" 2>/dev/null || echo "")

# Modelos obligatorios
local required_models=("qwen3:8b" "nomic-embed-text")
local optional_models=("qwen3:32b")

for model in "${required_models[@]}"; do
    # Comprobar si el nombre del modelo está instalado
    local base_name="${model%%:*}"
    if echo "$installed" | grep -q "$base_name"; then
        success "$model ya está instalado"
    else
        info "Descargando $model (Modelo obligatorio)..."
        ollama pull "$model" || warn "Fallo al descargar $model – complételo manualmente"
    fi
done

for model in "${optional_models[@]}"; do
    local base_name="${model%%:*}"
    if echo "$installed" | grep -q "$base_name"; then
        success "$model ya está instalado"
    else
        info "$model no está instalado (opcional, para mejor calidad)"
        info "  Instálelo más tarde con: ollama pull $model"
    fi
done

}

============================================================================

Paso 3: Entorno Virtual + Instalación

============================================================================

setup_venv() {
header "Entorno Virtual de Python"

if [[ -d "$VENV_DIR" ]]; then
    info "Se encontró un venv existente en: $VENV_DIR"
    # shellcheck disable=SC1091
    source "$VENV_DIR/bin/activate"
    success "venv activado"
else
    info "Creando venv en $VENV_DIR ..."
    python3 -m venv "$VENV_DIR"
    # shellcheck disable=SC1091
    source "$VENV_DIR/bin/activate"
    pip install --upgrade pip setuptools wheel --quiet
    success "venv creado y activado"
fi

}

install_jarvis() {
header "Instalando Jarvis"

local install_extras="$1"

info "Instalando jarvis[$install_extras] desde $REPO_DIR ..."
pip install -e "${REPO_DIR}[${install_extras}]" --quiet 2>&1 | tail -5

# Verificar instalación
if python3 -c "import jarvis; print(f'Jarvis v{jarvis.__version__}')" 2>/dev/null; then
    success "Jarvis instalado con éxito"
else
    fatal "La instalación ha fallado"
fi

# Comprobar Jarvis-CLI
if "$VENV_DIR/bin/jarvis" --version &>/dev/null; then
    local ver
    ver=$("$VENV_DIR/bin/jarvis" --version 2>&1)
    success "CLI disponible: $ver"
else
    warn "CLI 'jarvis' no está en el PATH – use: $VENV_DIR/bin/jarvis"
fi

}

============================================================================

Paso 4: Estructura de directorios + Configuración

============================================================================

setup_directories() {
header "Creando estructura de directorios"

# Jarvis --init-only crea todo
"$VENV_DIR/bin/jarvis" --init-only 2>/dev/null || true
success "Estructura de directorios creada en $JARVIS_HOME"

# Archivo de configuración
local config_file="$JARVIS_HOME/config.yaml"
if [[ -f "$config_file" ]]; then
    info "config.yaml ya existe – no será sobrescrito"
else
    cp "$REPO_DIR/config.yaml.example" "$config_file"
    success "config.yaml creado desde la plantilla"
fi

# .env (opcional)
local env_file="$JARVIS_HOME/.env"
if [[ ! -f "$env_file" ]]; then
    cp "$REPO_DIR/.env.example" "$env_file"
    chmod 600 "$env_file"
    success ".env creado (permisos: 600)"
fi

# Resumen de directorios
info "Estructura:"
find "$JARVIS_HOME" -maxdepth 2 -type d | sort | head -20 | while read -r dir; do
    echo "    ${dir#$HOME/}"
done

}

============================================================================

Paso 5: Servicios de Systemd

============================================================================

install_systemd() {
header "Servicios de Systemd"

local service_dir="$HOME/.config/systemd/user"
mkdir -p "$service_dir"

# Jarvis Core Service
local service_file="$service_dir/jarvis.service"
cat > "$service_file" << UNIT

[Unit]
Description=Jarvis Agent OS
Documentation=https://github.com/team-soellner/jarvis
After=network-online.target ollama.service
Wants=network-online.target

[Service]
Type=simple
ExecStart=${VENV_DIR}/bin/jarvis
WorkingDirectory=${JARVIS_HOME}
EnvironmentFile=-${JARVIS_HOME}/.env
Restart=on-failure
RestartSec=10
WatchdogSec=300

Seguridad

NoNewPrivileges=true
ProtectHome=read-only
ReadWritePaths=${JARVIS_HOME} /tmp/jarvis

Registro (Logging)

StandardOutput=journal
StandardError=journal
SyslogIdentifier=jarvis

[Install]
WantedBy=default.target
UNIT
success "jarvis.service creado"

# WebUI Service (opcional)
local webui_file="$service_dir/jarvis-webui.service"
cat > "$webui_file" << UNIT

[Unit]
Description=Jarvis Web-UI (FastAPI)
Documentation=https://github.com/team-soellner/jarvis
After=jarvis.service
BindsTo=jarvis.service

[Service]
Type=simple
ExecStart=${VENV_DIR}/bin/python -m uvicorn jarvis.channels.webui:create_app --host 127.0.0.1 --port 8080 --factory
WorkingDirectory=${JARVIS_HOME}
EnvironmentFile=-${JARVIS_HOME}/.env
Restart=on-failure
RestartSec=5

Seguridad

NoNewPrivileges=true
ProtectHome=read-only
ReadWritePaths=${JARVIS_HOME} /tmp/jarvis

Registro (Logging)

StandardOutput=journal
StandardError=journal
SyslogIdentifier=jarvis-webui

[Install]
WantedBy=default.target
UNIT
success "jarvis-webui.service creado"

# Daemon Reload
systemctl --user daemon-reload 2>/dev/null || true
success "systemd daemon-reload realizado"

info "Gestión de servicios:"
info "  systemctl --user start jarvis         # Iniciar"
info "  systemctl --user stop jarvis          # Detener"
info "  systemctl --user enable jarvis        # Autoinicio"
info "  journalctl --user -u jarvis -f        # Logs"
info "  systemctl --user start jarvis-webui   # Iniciar Web-UI"

}

============================================================================

Paso 6: Logrotate

============================================================================

setup_logrotate() {
header "Rotación de Logs"

local logrotate_dir="$JARVIS_HOME/logrotate.d"
mkdir -p "$logrotate_dir"

cat > "$logrotate_dir/jarvis" << CONF

${JARVIS_HOME}/logs/*.log {
daily
missingok
rotate 14
compress
delaycompress
notifempty
dateext
dateformat -%Y-%m-%d
create 0640
}

${JARVIS_HOME}/logs/*.jsonl {
daily
missingok
rotate 30
compress
delaycompress
notifempty
dateext
dateformat -%Y-%m-%d
create 0640
}
CONF
success "Configuración de logrotate creada"
info "Para logrotate del sistema: sudo ln -s $logrotate_dir/jarvis /etc/logrotate.d/jarvis"
}

============================================================================

Paso 7: Smoke-Test (Prueba de humo)

============================================================================

run_smoke_test() {
header "Ejecutando Smoke-Test"

"$VENV_DIR/bin/python" "$REPO_DIR/scripts/smoke_test.py" \
    --jarvis-home "$JARVIS_HOME" \
    --ollama-url "$OLLAMA_URL" \
    --venv "$VENV_DIR"

}

============================================================================

Paso 8: Integración con la Shell

============================================================================

setup_shell_integration() {
header "Integración con la Shell"

local shell_rc=""
if [[ -f "$HOME/.bashrc" ]]; then
    shell_rc="$HOME/.bashrc"
elif [[ -f "$HOME/.zshrc" ]]; then
    shell_rc="$HOME/.zshrc"
fi

local alias_line="alias jarvis='${VENV_DIR}/bin/jarvis'"
local activate_line="# Jarvis Agent OS"

if [[ -n "$shell_rc" ]]; then
    if grep -qF "Jarvis Agent OS" "$shell_rc" 2>/dev/null; then
        info "La integración con la shell ya existe en $shell_rc"
    else
        {
            echo ""
            echo "$activate_line"
            echo "$alias_line"
        } >> "$shell_rc"
        success "Alias 'jarvis' añadido a $shell_rc"
    fi
else
    info "No se encontró .bashrc/.zshrc – añádalo manualmente:"
    info "  $alias_line"
fi

}

============================================================================

Desinstalación

============================================================================

uninstall() {
header "Desinstalando Jarvis"

warn "Esto eliminará la instalación de Jarvis (PERO NO los datos en ~/.jarvis)"

read -rp "¿Continuar? [y/N] " confirm
if [[ "$confirm" != "y" && "$confirm" != "Y" ]]; then
    info "Operación cancelada."
    exit 0
fi

# Detener servicios
systemctl --user stop jarvis jarvis-webui 2>/dev/null || true
systemctl --user disable jarvis jarvis-webui 2>/dev/null || true

# Eliminar archivos de servicio
rm -f "$HOME/.config/systemd/user/jarvis.service"
rm -f "$HOME/.config/systemd/user/jarvis-webui.service"
systemctl --user daemon-reload 2>/dev/null || true

# Eliminar venv
if [[ -d "$VENV_DIR" ]]; then
    rm -rf "$VENV_DIR"
    success "Entorno Virtual eliminado"
fi

# Eliminar alias de la shell
for rc in "$HOME/.bashrc" "$HOME/.zshrc"; do
    if [[ -f "$rc" ]]; then
        sed -i '/Jarvis Agent OS/d' "$rc"
        sed -i "/jarvis.*venv.*bin.*jarvis/d" "$rc"
    fi
done

success "Jarvis ha sido desinstalado"
info "Los datos en $JARVIS_HOME NO han sido borrados"
info "Para eliminarlos completamente: rm -rf $JARVIS_HOME"

}

============================================================================

Resumen

============================================================================

show_summary() {
header "Instalación completada"

echo -e "${GREEN}${BOLD}"
cat << 'DONE'

✓ ¡Jarvis Agent OS instalado con éxito!
DONE
echo -e "${NC}"

echo "  Para iniciar:"
echo "    jarvis                               # Chat vía CLI"
echo "    jarvis --config ~/mi-config.yaml     # Configuración propia"
echo ""
echo "  Systemd:"
echo "    systemctl --user start jarvis        # Como servicio"
echo "    systemctl --user enable jarvis       # Autoinicio"
echo ""
echo "  Directorios:"
echo "    $JARVIS_HOME/                        # Carpeta Home"
echo "    $JARVIS_HOME/config.yaml             # Configuración"
echo "    $JARVIS_HOME/memory/                 # Todos los recuerdos"
echo "    $JARVIS_HOME/logs/                   # Logs + Auditoría"
echo ""
echo "  Próximos pasos:"
echo "    1. Revisar y ajustar config.yaml"
echo "    2. Iniciar y probar jarvis"
echo "    3. Opcional: Activar Telegram/WebUI"
echo ""

}

============================================================================

Main

============================================================================

main() {
show_banner

local mode="${1:-interactive}"

case "$mode" in
    --uninstall)
        uninstall
        exit 0
        ;;
    --systemd)
        install_systemd
        exit 0
        ;;
    --minimal)
        check_prerequisites
        setup_venv
        install_jarvis ""
        setup_directories
        run_smoke_test
        show_summary
        ;;
    --full)
        check_prerequisites
        ensure_ollama_models
        setup_venv
        install_jarvis "full"
        setup_directories
        install_systemd
        setup_logrotate
        setup_shell_integration
        run_smoke_test
        show_summary
        ;;
    --help|-h)
        echo "Uso: $0 [--minimal|--full|--systemd|--uninstall|--help]"
        echo ""
        echo "  (sin argumentos)   Instalación interactiva"
        echo "  --minimal          Solo paquetes Core"
        echo "  --full             Todo incluido: Voice + Systemd"
        echo "  --systemd          Instalar solo servicios de Systemd"
        echo "  --uninstall        Desinstalación"
        exit 0
        ;;
    *)
        # Instalación interactiva (Predeterminada)
        check_prerequisites
        ensure_ollama_models
        setup_venv
        install_jarvis "all,dev"
        setup_directories
        install_systemd
        setup_logrotate
        setup_shell_integration
        run_smoke_test
        show_summary
        ;;
esac

}

main "$@"