BioSphere

Rehber

BioSphere'i kendi bilgisayarınızda çalıştırın

BioSphere bir hizmet değil, indirip çalıştırdığınız bir yazılım: her şey sizin bilgisayarınızda olur, hiçbir veri bize gelmez. Windows'ta yaklaşık on beş dakikalık kurulumdan sonra ilk turunuzu oluşturabilirsiniz.

Panel bu sitede değil, sizin bilgisayarınızda

Bu sayfa projenin tanıtımı. Videoyu 360 tura çeviren motor, paneliniz, odalarınız ve API anahtarınız kendi bilgisayarınızda çalışır; buraya hiçbir şey yüklenmez. Aşağıdaki adımlardan sonra panel http://localhost:3000/evler adresinde açılır.

Adım adım (Windows)

  1. 1

    Gerekenleri kurun

    Git, Python paket yöneticisi uv, Node.js ve FFmpeg. Windows'ta hepsi winget ile tek satırda kurulur; her birini kurduktan sonra terminali kapatıp yeniden açın.

    shell
    winget install Git.Gitwinget install astral-sh.uvwinget install OpenJS.NodeJS.LTSwinget install Gyan.FFmpeg

    NVIDIA ekran kartınız varsa güncel sürücüyü de kurun; 3B gezinti ve yapay zekâ araçları GPU ister. 360 tur için GPU gerekmez.

  2. 2

    Projeyi indirin

    Depoyu istediğiniz bir klasöre klonlayın.

    shell
    git clone https://github.com/bilalgurkansanli/BioSphereAI.gitcd BioSphereAI
  3. 3

    Kurulumu çalıştırın

    Betik Python ortamını ve web bağımlılıklarını kurar, sonunda makinenizi kontrol eder. Windows yerel betikleri varsayılan olarak çalıştırmadığı için komut bu izni yalnızca bu çalıştırma için verir.

    shell
    powershell -ExecutionPolicy Bypass -File .\scripts\setup.ps1# GPU'nuz varsa (yapay zekâ araçları için):powershell -ExecutionPolicy Bypass -File .\scripts\setup.ps1 -Gpu
  4. 4

    Başlatın

    scripts klasöründeki start-dev.cmd dosyasına çift tıklayın. Motor ve panel kendi pencerelerinde açılır; durdurmak için pencereyi kapatmanız yeterli.

    shell
    scripts\start-dev.cmd

    Motor açıldıktan sonraki ilk dakikada panel GPU'yu ve araçları denetlerken "kontrol ediliyor" diyebilir; birkaç saniye bekleyin.

  5. 5

    Paneli açın

    Tarayıcıda http://localhost:3000/evler adresine gidin. Giriş ekranı yok: kendi bilgisayarınızda çalıştığı için panel doğrudan açılır.

    shell
    http://localhost:3000/evler
  6. 6

    İlk turunuzu oluşturun

    "Yeni ev" ile bir ev oluşturun, "Sahne ekle" → "Video yükle" ile odanın ortasında telefonu yavaşça kendi etrafında çevirdiğiniz bir videoyu yükleyin. Yaklaşık üç dakikada panorama hazır olur; tur sayfasından oynatıcıyı açıp diğer odaları ekleyebilirsiniz.

    İyi bir çekim için: telefonu dikey tutun, kendi ekseninizde yavaşça dönün; göz hizasında bir tur, sonra biraz yukarı ve biraz aşağı bakarak birer tur. Videoyu mesajlaşma uygulamasından değil, telefonun kendisinden aktarın.

İsteğe bağlı özellikler

Telefonla rehberli çekim

Telefon kamerası yalnızca HTTPS üzerinde açılır. Bilgisayarınızın yerel ağ adresini scripts/certs/san.cnf dosyasına IP.2 olarak ekleyin, bir kez sertifika üretin; start-dev.cmd telefon vekilini de açar. Telefonda https://<bilgisayarın-IP'si>:3443 adresini açıp sertifika uyarısını bir kez kabul edin, sonra "Sahne ekle" → "Telefonla çek" QR kodunu okutun.

shell
openssl req -x509 -newkey rsa:2048 -nodes -days 825 -keyout scripts/certs/key.pem -out scripts/certs/cert.pem -config scripts/certs/san.cnf -extensions v3

İlan metni ve yatırım asistanı

Kendi Anthropic API anahtarınızla çalışır; proje anahtarla gelmez. Eki bir kez kurun, sonra panelde Ayarlar → "Anthropic API anahtarı" alanına anahtarınızı yapıştırıp "Anahtarı test et"e basın. Motoru yeniden başlatmanız gerekmez. Anahtar yokken bu özellikler kapalı kalır; geri kalan her şey çalışır.

shell
cd engineuv pip install -e ".[listing]"# then: http://localhost:3000/ayarlar

Mobilya kaldırma ve dekor (GPU)

Kurulumu -Gpu ile çalıştırın ve modellerin ilk kullanımda inebilmesi için engine/.env içine izni ekleyin. Bu araçlar prototip aşamasında; model lisanslarını THIRD_PARTY_NOTICES dosyasında görebilirsiniz.

shell
echo BIOSPHERE_AI_ALLOW_DOWNLOADS=true >> engine\.env

3B gezinti (GPU)

Eki kurun, Brush v0.3.0 ikilisini ve @playcanvas/splat-transform paketini indirip yollarını engine/.env içinde verin (örnek değerler .env.example'da). Panelde ev sayfasındaki 3B kartı yürüyüş videosunu yükleyip modeli eğitir; GPU ile yaklaşık yarım saat sürer.

shell
cd engineuv pip install -e ".[walkthrough]"

Linux ve macOS

Betikler Windows için yazıldı; diğer sistemlerde aynı adımları elle çalıştırın.

shell
# Linux / macOSgit clone https://github.com/bilalgurkansanli/BioSphereAI.git && cd BioSphereAIcd engine && uv venv --python 3.12 .venv && uv pip install -e ".[dev]".venv/bin/python -m uvicorn biosphere.api.main:app --port 8008 &cd ../web && npm install && npm run dev

Sorun giderme

"Betik çalıştırma bu sistemde devre dışı" hatası
Komutu powershell -ExecutionPolicy Bypass -File ile çalıştırın ya da scripts\start-dev.cmd kullanın; .cmd dosyaları bu ayardan etkilenmez.
Port kullanımda (8008 ya da 3000)
Önceki pencereler hâlâ açık olabilir; onları kapatıp yeniden başlatın.
Telefonda sayfa açılıyor ama dokunmalara tepki vermiyor
Telefonu bilgisayarla aynı ağa bağlayın ve adresi IP ile açın (https://<IP>:3443); geliştirme sunucusu yalnızca yerel ağ adreslerine izin verir.
iPhone sertifika yüzünden sayfayı açmıyor
Sertifikadaki IP, telefonda yazdığınız adresle aynı olmalı. san.cnf'ye doğru IP'yi ekleyip sertifikayı yeniden üretin.
Bir özellik görünmüyor ya da kapalı
http://127.0.0.1:8008/api/v1/health adresi makinenizde neyin çalıştığını söyler: FFmpeg, GPU, 3B gezinti araçları ve yapay zekâ modelleri.

Başkalarının da erişeceği bir kurulum mu?

Panel varsayılan olarak giriş istemez, çünkü kendi bilgisayarınızda yalnızca size açıktır. Başkalarının ulaşabileceği bir sunucuda çalıştıracaksanız engine/.env içinde hesap modunu açın, HTTPS kullanın ve kendi gizlilik metninizi yayımlayın.

shell
BIOSPHERE_AUTH_MODE=accountsBIOSPHERE_ENV=production

Takıldığınız bir yer olursa GitHub'da bir issue açın. Issue aç