Instalacion

import { Aside, Steps, Tabs, TabItem } from ‘@astrojs/starlight/components’;

Opcion A: Instalacion local

Clona el repositorio

git clone https://github.com/pepetox/osint-ai-one.git
cd osint-ai-one

Crea y activa el entorno virtual

python -m venv .venv
source .venv/bin/activate  # Linux/macOS
# .venv\Scripts\activate   # Windows (PowerShell)

Instala el paquete
Ventana de terminal
```
pip install -e .
```
Esto instala el paquete en modo editable y registra los entry points: osint-agent, osint-mcp, osint-a2a.

Configura las variables de entorno

cp .env.example .env

Edita .env con tu editor preferido. Como minimo, añade una API key:

# .env — minimo para empezar
VIRUSTOTAL_API_KEY=tu_clave_aqui

# LLM local (por defecto)
LLM_PROVIDER=ollama
OLLAMA_MODEL=qwen3:14b

Descarga el modelo Ollama
Ventana de terminal
```
ollama pull qwen3:14b
```
Verifica la instalacion
Ventana de terminal
```
osint-agent --help
```
Deberias ver el menu de ayuda del CLI.

Opcion B: Docker

```bash git clone https://github.com/pepetox/osint-ai-one.git cd osint-ai-one cp .env.example .env # Edita .env con tus API keys

docker compose run --rm --profile cli osint-agent
```

```bash docker compose --profile server up -d ``` - MCP Server: `http://localhost:8080` - A2A Server: `http://localhost:9000` ```bash docker compose run --rm --profile cli osint-agent -q "Investiga la IP 8.8.8.8" ```

Verificar la instalacion

# El agente debe arrancar sin errores
osint-agent

# En el prompt interactivo, prueba una query simple
osint> Investiga la IP 8.8.8.8

Si ves errores de conexion a Ollama, asegurate de que el servicio esta corriendo:

ollama serve  # En otra terminal si no esta como servicio
ollama list   # Verifica que el modelo esta descargado

Instalacion para desarrollo

Si quieres contribuir o ejecutar los tests:

pip install -e ".[dev]"
pytest tests/ -v

Ver Desarrollo → Tests para mas detalles.