Skip to main content

Permulaan pantas

Jalankan gerbang, loggerd dan admin sebagai satu proses pada mesin anda. Port yang diterbitkan hanya terikat pada 127.0.0.1.

Atau cuba tanpa memasang​

Stand awam yang diurus oleh pengendali (endpoint serasi OpenAI, konsol pentadbir) tersedia di https://yabanin.ai: halakan mana-mana klien ke https://yabanin.ai/gw/v1 dengan kunci stand — Docker tempatan tidak diperlukan. Minta kelayakan daripada pengendali; stand menjalankan tindanan permulaan pantas yang sama, jadi selebihnya panduan ini terpakai tanpa perubahan. Lihat Stand awam untuk mengetahui apa stand itu dan bagaimana ia dilaksanakan semula.

Keperluan​

  • Docker dengan Compose v2
  • make, openssl dan curl
  • kira-kira 4 GB RAM untuk binaan imej dan kontena

Lima arahan​

Daripada akar repositori:

bash scripts/quickstart/init-env.sh
make quickstart-up
make quickstart-seed
make quickstart-smoke KEY=yb_... # the key seed printed once
make quickstart-down

init-env.sh menulis deploy/quickstart/.env dengan tiga kunci rawak dan menetapkan mod 600. Jika file itu sudah wujud, skrip membiarkannya. make quickstart-up menjalankan skrip yang sama, membina imej, dan memulakan Postgres, Redis, migrasi, proses semua-dalam-satu yabanin dev, serta penyedia mock pilihan (profil Compose mock).

make quickstart-seed menjalankan perkhidmatan sekali larian yabanin seed yang kanonik: ia mencipta organisasi, pasukan lalai, bajet, model, kredit permulaan, kunci API dan pentadbir root dalam satu langkah, kemudian mencetak kunci API sekali dan kata laluan pentadbir sekali. Simpan kedua-duanya. Arahan itu tidak menulisnya ke file. Menjalankannya semula ialah no-op yang selamat: kunci benih digunakan semula dan teks biasa tidak ditunjukkan lagi.

Pentadbir​

Buka http://127.0.0.1:8086 dan log masuk dengan QS_ADMIN_EMAIL (admin@localhost melainkan anda mengubahnya) dan kata laluan daripada benih.

Model sebenar​

Sunting deploy/quickstart/.env sebelum benih:

  • QS_MODEL — nama registri
  • QS_UPSTREAM_URL — URL asas serasi OpenAI yang boleh dicapai dari kontena yabanin

Benih mendaftarkan model dengan penyedia openai-compat. Itu merangkumi pelayan serasi OpenAI secara langsung, termasuk endpoint /v1/chat/completions llama.cpp. Untuk penyesuai khusus penyedia (llamacpp, vllm, ...), daftarkan model dalam konsol pentadbir selepas benih (halaman Model).

Untuk pelayan llama.cpp tempatan, mulakan profil daripada file compose utama:

docker compose -f deploy/docker-compose.yml --profile llamacpp up -d

Halakan QS_UPSTREAM_URL ke pelayan itu.

Sebagai alternatif, langkau penyuntingan .env dan tambah kunci penyedia bagi setiap organisasi dalam konsol pentadbir selepas benih — lihat BYOK (Tetapan → Kunci penyedia).

Untuk melangkau penyedia mock, jalankan Compose tanpa --profile mock dan tetapkan URL huluan sebelum benih. make quickstart-up menyertakan profil supaya panggilan chat asap ada tempat untuk dituju.

Henti​

make quickstart-down menghentikan tindanan dan mengekalkan volum pangkalan data. Tambah down -v sendiri apabila anda mahu pangkalan data yang bersih.

Had​

  • Pengguna dan kata laluan Postgres dalam file compose ini ialah nilai dev yang tetap (yabanin).
  • Kunci sesi, HMAC dan penyulitan yang dijana adalah untuk file tempatan ini sahaja.
  • Tiada apa-apa yang mendengar pada 0.0.0.0.
  • Tindanan ini bukan pelaksanaan pengeluaran.