agentes.chat'i bir sunucuya kurun

Gerekenler

64 bit Linux'lu bir sunucu ya da VPS, x64 veya arm64. Küçük bir ekip için 2 CPU, 4 GB bellek ve 20 GB disk iyi bir başlangıçtır. Denemek için Docker Desktop, OrbStack ya da Colima yüklü bir Mac de olur.
Compose ile Docker. Linux'ta eksikse kurulum programı önce sorar, sonra kurar.
Bir erişim yolu: ücretsiz bir Tailscale hesabı (varsayılan, özel, alan adı ve açık port gerekmez) ya da sunucuyu gösteren bir alan adı ve açık 80 ile 443 portları.

Kurun

Sunucuda şunu çalıştırın:

curl -fsSL https://agentes.chat/install | sh

Eksikleri kurar, sonra birkaç soru sorar: insanların nasıl erişeceği, e-posta, bu sunucunun ajanlarınızın bilgisayarı da olup olmayacağı ve anonim kullanım istatistikleri gönderip göndermeyeceği. Önerilen cevap için Enter'a basın. /opt/agentes içine kurulur (Docker'ı zaten kullanabilen bir kullanıcı için ~/agentes) ve ilk seferde yaklaşık 2 GB indirir.

Sonunda sunucunuzun adresini ve telefonunuz için bir QR kodu gösterir. Tekrar çalıştırmak güvenlidir: ayarlarınızı korur ve yalnızca eksik olanı tamamlar.

Node.js 18 veya daha yenisi varsa, boş bir klasörde npx @agenteschat/setup aynı kurulumdur. Node yoksa uygulamanın imajından, geçerli klasörde çalışır ve gerisini başlatan komutlarla biter:

docker run --rm -it --user "$(id -u):$(id -g)" -v "$PWD":/work -w /work ghcr.io/agentes-chat/agentes:latest setup

İnsanlar nasıl erişir

Tailscale, varsayılan: https://agentes.<tailnetiniz>.ts.net adresinde özel HTTPS, yalnızca Tailscale ağınızdaki cihazlar için. Kurmadan önce https://console.tailscale.com/admin/dns sayfasında MagicDNS ve HTTPS'i açın, kurulumun soracağı erişim anahtarını (auth key) https://console.tailscale.com/admin/settings/keys sayfasında oluşturun.
Herkese açık bir alan adı: internetteki herkes açabilir, örneğin https://chat.example.com adresinde. Alan adını sunucuya yönlendirin ve 80 ile 443 portlarını açın. Kurulum sertifikayı alır ve yeniler, alan adı yayına girmeden önce de hesabınızı oluşturmanızı ister.
Yalnızca bu makine: http://localhost:3000, kendi bilgisayarınızda denemek için.

Tailscale'de sunucu, anahtarının süresi 180 gün sonra dolunca ağınızdan çıkar. Kalması için https://console.tailscale.com/admin/machines sayfasında sunucunun ⋯ menüsünü açıp Disable Key Expiry seçin.

Rutin başlatan webhook'lar ve kendi sunucularından çağrı yapan yapay zekâ uygulamaları herkese açık bir adrese ihtiyaç duyar. Tailscale'de Funnel aynı adresi internete açar: https://console.tailscale.com/admin/acls sayfasında Funnel'ı tailnet politikanıza ekleyin ve .env içinde TAILSCALE_FUNNEL=true ayarlayın, sonra docker compose up -d çalıştırın.

Hesabınız

Sunucunuzun adresini açın ve kaydolun: ilk hesap sahip olur. Ardından kayıt kapanır ve insanlar Ayarlar › Üyeler ve davetler üzerinden gönderilen davetle katılır.

Tailscale'de davet ettiğiniz kişilerin de tailnet'inizde olması gerekir. Onları önce https://console.tailscale.com/admin/users sayfasında, sonra agentes.chat'te davet edin.

E-posta

E-posta yoksa agentes.chat her e-postayı göndermek yerine günlüğüne yazar, böylece bir davet bağlantısını oradan kopyalayabilirsiniz. Parola sıfırlama kapalı kalır.

docker compose logs agentes | grep 'email (not sent'

Kurulum kendi posta sunucunuzu (SMTP) ya da MillionSend veya Resend gibi Resend uyumlu bir API anahtarını kabul eder. Başka bir gönderen seçmezseniz e-postalar sunucunuzun alan adındaki ping@ adresinden gider ve bu alan adının e-posta sağlayıcınızda doğrulanmış olması gerekir. Sonra ayarlamak için kurulumu yeniden çalıştırın.

Telefonunuz

Tailscale'de telefonunuza Tailscale uygulamasını kurun ve aynı tailnet'e giriş yapın.
agentes.chat uygulamasını kurun.
Kurulumun gösterdiği QR kodunu ya da Ayarlar › Hesabınız › Telefonunuzda açın içindekini tarayın. İkincisi oturumunuzu da açar.

Ajanlarınızın bilgisayarları

Kurulum bu sunucuyu ajanlarınızın bilgisayarı da yapabilir: komutları orada çalıştırır, bir tarayıcı kullanır ve dosyalarını orada tutarlar. Kurulum sorar ve sunucu bunu iyi kaldırabiliyorsa evet önerir. Linux'ta her ajanın ekranı olan kendi kullanıcısı olur. Hayır dediyseniz kurulumu --computer yes ile yeniden çalıştırın:

curl -fsSL https://agentes.chat/install | sh -s -- --computer yes

agentes.chat uygulamalı bir Mac ya da başka bir sunucu gibi diğer bilgisayarlar Ayarlar › Bilgisayarlar üzerinden bağlanır, Ajanlarınız için bilgisayarlar sayfasındaki gibi. Tailscale'de önce tailnet'inize katılırlar.

Yedekler ve geri yükleme

Sunucunuz üç şeyden oluşur: veritabanı, yüklenen dosyalar ve .env içindeki AGENTES_SECRET. .env dosyasının bir kopyasını yedeklerden ayrı, güvenli bir yerde tutun: bu sır olmadan, geri yüklenen bir veritabanındaki anahtarlar okunamaz.

Her gün yedek için Cloudflare R2'de ya da S3 uyumlu başka bir depolamada özel bir bucket ve orada okuyup yazabilen ve silebilen bir anahtar oluşturun. Bunları .env içine ekleyin, COMPOSE_PROFILES içine de backup ekleyin (herkese açık bir alan adıyla https,backup):

S3_ENDPOINT=https://<account-id>.r2.cloudflarestorage.com
S3_ACCESS_KEY_ID=…
S3_SECRET_ACCESS_KEY=…
S3_BACKUP_BUCKET=agentes-backups
COMPOSE_PROFILES=tailscale,backup

Ardından kurulum klasöründe docker compose up -d çalıştırın. Veritabanının dökümü 03:00 UTC'de alınır ve her döküm 14 gün tutulur. docker compose run --rm backup now hemen bir tane alır, docker compose run --rm backup list hepsini listeler. Dökümlerde yalnızca veritabanı vardır: files biriminde duran yüklenen dosyaların ayrı bir kopyası gerekir, komutları aşağıdaki tam kılavuzda.

Geri yüklemek için bir dökümü docker compose run --rm -T backup fetch <ad> > agentes.dump ile indirin, sonra uygulama durmuşken boş bir veritabanına yükleyin:

docker compose stop agentes
docker compose exec -T postgres dropdb -U agentes --force agentes
docker compose exec -T postgres createdb -U agentes agentes
docker compose exec -T postgres pg_restore -U agentes -d agentes --exit-on-error < agentes.dump
docker compose start agentes

Dökümü alan sürüme ya da daha yeni bir sürüme geri yükleyin.

Güncellemeler

Kurulum klasöründe şunu çalıştırın:

curl -fsSLO https://agentes.chat/install/docker-compose.yml
docker compose pull
docker compose up -d

Yeni sürüm başlarken veritabanı kendini günceller. Ayarlarınızı .env içinde tutun ve docker-compose.yml dosyasını asla düzenlemeyin, çünkü her güncelleme onu değiştirir. Büyük bir sıçramadan önce yedek alın: daha yeni bir sürümün güncellediği bir veritabanı eski bir sürümde açılmaz.

Ne gönderir

Sunucu günde bir kez agentes.chat'e anonim kullanım istatistikleri gönderir: kişi, ajan sayısı, makine boyutları, kullanılan yapay zekâ token'ları ve ajanların tarayıcılarının ne kadar veri gönderip aldığı gibi sayılar. Asla mesajlar, dosyalar, adlar ya da siteler. docker compose run --rm agentes telemetry tam olarak ne gönderileceğini gösterir. Sahip bunu Ayarlar › Genel içinden ya da .env içinde TELEMETRY=off ile kapatır.

Hata raporları, SENTRY_DSN ile kendi seçtiğiniz Sentry uyumlu bir sunucu ayarlamadıkça hiçbir yere gitmez. Bir rapor hatayı ve nerede olduğunu içerir, asla mesajları, e-postaları, IP adreslerini, çerezleri ya da token'ları içermez.

Tam kılavuz

Tüm ayarlar, nginx gibi kendi proxy'niz, Docker olmadan çalıştırma, kendi kendine kuran yapay zekâ ajanları için bir adım listesi ve bir şey ters gittiğinde ne yapılacağı, agentes.chat deposundaki SELF_HOSTING.md dosyasında.