Manuel kurulum

Yapılandırma üzerinde tam kontrol sağlamak istediğinizde veya etkileşimli kurulum programını çalıştıramadığınızda manuel yolu kullanın.

1. Çalışma dizini oluşturun

mkdir -p ~/pentagi && cd ~/pentagi

2. Ortam dosyasını indirin

test -f .env || curl -fo .env.new https://raw.githubusercontent.com/vxcontrol/pentagi/main/.env.example
test -f .env.new && openssl rand -hex 32 | xargs -I VALUE sed -E -i.bak 's/^COOKIE_SIGNING_SALT=salt( .*)?$/COOKIE_SIGNING_SALT=VALUE/' .env.new
test -f .env.new && openssl rand -hex 16 | xargs -I VALUE sed -E -i.bak 's/^PENTAGI_POSTGRES_PASSWORD=postgres( .*)?$/PENTAGI_POSTGRES_PASSWORD=VALUE/' .env.new
test -f .env || mv .env.new .env

Compose dosyası üç provider yapılandırma dosyasını bağlar; bu nedenle bunları oluşturun — boş dosyalar yeterlidir:

touch example.custom.provider.yml example.ollama.provider.yml example.bedrock.provider.yml

Özel bir OpenAI uyumlu uç nokta veya Ollama kullanmayı planlıyorsanız, boş dosyalar yerine örnek yapılandırmaları indirin ve .env içindeki LLM_SERVER_CONFIG_PATH veya OLLAMA_SERVER_CONFIG_PATH değerlerini /opt/pentagi/conf/custom.provider.yml veya /opt/pentagi/conf/ollama.provider.yml olarak ayarlayın. Özel örnek, aralarında 23 Ekim 2026 tarihinde OpenAI tarafından emekliye ayrılacak olan o3-mini'in de bulunduğu OpenAI modellerini adlandırır; her agent'in model değerini uç noktanızın sunduğu bir model olarak ayarlayın:

curl -o example.custom.provider.yml https://raw.githubusercontent.com/vxcontrol/pentagi/main/examples/configs/custom-openai.provider.yml
curl -o example.ollama.provider.yml https://raw.githubusercontent.com/vxcontrol/pentagi/main/examples/configs/ollama-llama318b.provider.yml

3. En az bir LLM provider ekleyin

.env dosyasını düzenleyin ve en az bir provider için anahtarı ayarlayın:

OPEN_AI_KEY=your_openai_key
ANTHROPIC_API_KEY=your_anthropic_key
GEMINI_API_KEY=your_gemini_key

AWS Bedrock, Ollama, DeepSeek, GLM, Kimi, Qwen, MiniMax, Mistral, xAI ve özel uç noktalar gibi diğer providers LLM providers bölümünde açıklanmıştır. Search engines isteğe bağlıdır; DuckDuckGo ve Sploitus için anahtar gerekmez:

DUCKDUCKGO_ENABLED=true
SPLOITUS_ENABLED=true
TAVILY_API_KEY=your_tavily_key

4. Yığını başlatın

curl -O https://raw.githubusercontent.com/vxcontrol/pentagi/main/docker-compose.yml
test -f .env && docker compose up -d

Web arayüzü https://localhost:8443 adresinde sunulur. [email protected] / admin ile oturum açın ve parolayı değiştirin.

Web kullanıcı arayüzü ve diğer hizmetler localhost ile sınırlıdır, ancak her flow'un sandbox'ı, varsayılan olarak 28000–29999 aralığında iki geri çağırma bağlantı noktasını Docker ana bilgisayarının tüm arayüzlerinde yayımlar ve ufw bunları filtrelemez. Başkalarının erişebileceği bir ana bilgisayarda, önce bu aralığı kısıtlayın — bkz. Ağ maruziyeti. Kurulumu daha sonra güncellemek için Yükseltme bölümünü izleyin.

İsteğe bağlı yığınlar

Her isteğe bağlı hizmet, temel yığının üzerine katmanlayabileceğiniz kendi compose dosyasıyla birlikte gelir: