> ## Documentation Index
> Fetch the complete documentation index at: https://docs.squidy.run/llms.txt
> Use this file to discover all available pages before exploring further.

# Instalação

> Como instalar o Squidy no seu ambiente

# 📦 Instalação

## Via pip (recomendado)

```bash theme={null}
pip install squidy
```

Verifique a instalação:

```bash theme={null}
squidy --version
```

## Via pipx (isolado)

Para instalação isolada sem conflitos:

```bash theme={null}
pipx install squidy
squidy --version
```

## Desenvolvimento

Clone o repositório e instale em modo de desenvolvimento:

```bash theme={null}
git clone https://github.com/seomarc/squidyrun.git
cd squidyrun
python -m venv venv && source venv/bin/activate  # Linux/Mac
# ou: python -m venv venv && venv\Scripts\activate  # Windows
pip install -e ".[dev]"
squidy --version
```

## Requisitos

* **Python:** 3.9 ou superior
* **Sistema:** Linux, macOS, Windows (WSL recomendado)

## Variáveis de Ambiente

Configure as chaves de API para uso com IA:

```bash theme={null}
# OpenAI
export OPENAI_API_KEY="sk-..."

# Anthropic (Claude)
export ANTHROPIC_API_KEY="sk-ant-..."
```

Ou use um arquivo `.env` no diretório do projeto.

## Atualização

```bash theme={null}
pip install --upgrade squidy
```

## Desinstalação

```bash theme={null}
pip uninstall squidy
```

## Solução de Problemas

### Comando não encontrado

Adicione o diretório de scripts do Python ao PATH:

```bash theme={null}
# Linux/Mac
export PATH="$HOME/.local/bin:$PATH"

# Windows
set PATH=%APPDATA%\Python\Scripts;%PATH%
```

### Conflitos de dependência

Use ambiente virtual:

```bash theme={null}
python -m venv venv
source venv/bin/activate
pip install squidy
```