vespper

Vespper-Pengembang Open-Source AI

Dokumen · Demo · Laporkan Bug · Permintaan Fitur · Blog · Slack

Catatan: Jika Anda ingin menggunakan Vespper untuk tim Anda atau untuk organisasi Anda, silakan hubungi kami. Proyek open-source ini cocok untuk penggunaan individu tunggal. Setiap fitur investigasi lanjutan akan berada di bawah Vespper-EE.

Anda dapat meninggalkan email Anda untuk diberitahu ketika penawaran cloud kami tersedia: https://tally.so/r/3eba5l

Ringkasan ?

Vespper adalah insinyur yang bertenaga AI. Secara otomatis dapat melompat ke insiden & peringatan dengan Anda, dan memberi Anda wawasan yang bermanfaat & kontekstual dan RCA secara real time.

Mengapa ❓

Kebanyakan orang tidak suka melakukan shift panggilan. Dibutuhkan insinyur untuk menjadi cepat dan menyelesaikan masalah dengan cepat. Selain itu, butuh waktu untuk mencapai akar penyebab masalah. Itu sebabnya kami mengembangkan Vespper. Kami percaya Gen AI dapat membantu pengembang panggilan secara lebih cepat memecahkan masalah.

Daftar isi

• Ringkasan
• Mengapa
• Fitur utama
• Demo
• Memulai
  • Prasyarat
  • Instalasi cepat
  • Memperbarui vespper
  • Penyebaran
  • Visualisasikan Basis Pengetahuan
• Dukungan dan umpan balik
• Berkontribusi pada Vespper
• Pemecahan masalah
• Telemetri
• Lisensi
• Pelajari lebih lanjut
• Kontributor

Fitur utama

• RCA otomatis : Vespper secara otomatis mendengarkan insiden/peringatan produksi dan secara otomatis menyelidikinya untuk Anda.
• Integrasi Slack : Vesper hidup di dalam kendur Anda. Cukup hubungkan dan nikmati insinyur panggilan yang tidak pernah tidur.
• Integrasi : Vespper terintegrasi dengan alat pengamatan/manajemen insiden yang populer seperti Datadog, Coralogix, OpsGenie dan PagerDuty. Ini juga terintegrasi ke alat lain sebagai GitHub, Notion, Jira dan Confluence untuk mendapatkan wawasan tentang insiden.
• UX intuitif : Vesper menawarkan pengalaman yang akrab. Anda dapat berbicara dengannya dan mengajukan pertanyaan tindak lanjut.
• Aman : Vespper-Host Self-Host dan memiliki data Anda. Selalu.
• Sumber Terbuka : Kami menyukai open-source. Tuan rumah swadaya dan gunakan secara gratis.

Demo?

Lihat video demo kami untuk melihat Vespper beraksi.

Memulai

Untuk menjalankan Vespper, Anda perlu mengkloning repo & menjalankan aplikasi menggunakan Docker Compose.

Prasyarat

Pastikan Anda telah menginstal berikut:

• Docker & Docker Compose - Aplikasi ini berfungsi dengan wadah Docker. Untuk menjalankannya, Anda harus memiliki Docker Desktop, yang dilengkapi dengan Docker CLI, Docker Engine dan Docker Compose.

Instalasi cepat? ️

Anda dapat menemukan video instalasi di sini.

1. Klon Repositori:

   git clone [email protected]:vespper/vespper.git && cd vespper

2. Konfigurasikan LitellM Proxy Server:

   Kami menggunakan LitellM Proxy Server untuk berinteraksi dengan 100+ LLMS dalam antarmuka terpadu (antarmuka OpenAI).

   1. Salin file contoh:

      cp config/litellm/.env.example config/litellm/.env
      cp config/litellm/config.example.yaml config/litellm/config.yaml

   2. Tentukan kunci openai Anda dan tempatkan di dalam config/litellm/.env sebagai OPENAI_API_KEY . Anda bisa mendapatkan kunci API Anda di sini. Yakinlah, Anda tidak akan dikenakan biaya kecuali Anda menggunakan API. Untuk detail lebih lanjut tentang harga, periksa di sini.

3. Salin file .env.example :

   cp .env.example .env

4. Buka file .env di editor favorit Anda (vim, vscode, emacs, dll):

   vim .env # or emacs or vscode or nano

5. Perbarui variabel -variabel ini:

   • SLACK_BOT_TOKEN , SLACK_APP_TOKEN dan SLACK_SIGNING_SECRET - variabel -variabel ini diperlukan untuk berbicara dengan vespper di slack. Ikuti panduan ini untuk membuat aplikasi Slack baru di organisasi Anda.

   • (Opsional) SMTP_CONNECTION_URL - Variabel ini diperlukan untuk mengundang anggota baru ke organisasi Vespper Anda melalui email dan memungkinkan mereka menggunakan bot. Tidak wajib jika Anda hanya ingin menguji Vespper dan bermain dengannya. Jika Anda ingin mengirim undangan ke anggota tim Anda, Anda dapat menggunakan layanan seperti SendGrid/Mailgun. Harus mengikuti pola ini: smtp://username:password@domain:port .

6. Luncurkan proyek:

   docker compose up -d

Itu saja. Anda harus dapat mengunjungi dasbor Vespper di http: // localhost: 5173. Cukup buat pengguna (dengan email yang sama dengan yang ada di pengguna Slack Anda) dan mulai mengkonfigurasi organisasi Anda. Jika sesuatu tidak berhasil untuk Anda, silakan periksa pemecahan masalah kami atau hubungi kami melalui saluran dukungan kami.

Langkah selanjutnya adalah mengonfigurasi organisasi Anda sedikit lebih banyak (menghubungkan alat manajemen insiden, membangun basis pengetahuan, dll). Buka bagian Connect & Configure di dokumen kami untuk informasi lebih lanjut?

Menggunakan gambar Dockerhub

Jika Anda mau, Anda dapat menarik gambar Docker kami dari Dockerhub alih -alih mengkloning repo & bangunan dari awal.

Untuk melakukan itu, ikuti langkah -langkah ini:

1. Unduh File Konfigurasi:

   curl https://raw.githubusercontent.com/vespper/vespper/main/tools/scripts/download_env_files.sh | sh

2. Ikuti langkah 2 dan 5 di atas untuk mengkonfigurasi proxy litellm dan file .env Anda masing -masing. Yaitu, Anda harus mengkonfigurasi kunci openAi Anda di config/litellm/.env dan mengkonfigurasi kredensial kendur Anda di root .env .

3. Memutar lingkungan menggunakan Docker Compose:

   curl https://raw.githubusercontent.com/vespper/vespper/main/tools/scripts/start.sh | sh

Itu saja? Anda harus dapat mengunjungi dasbor Vespper di http: // localhost: 5173.

Memperbarui Vespper? ‍♂️

1. Tarik perubahan terbaru:

   git pull

2. Membangun kembali gambar:

   docker-compose up --build -d

Penyebaran ☁️

Kunjungi Contoh Panduan kami untuk menggunakan Vespper ke Cloud Anda.

Visualisasikan Basis Pengetahuan? ️

Kami menggunakan Chromadb sebagai vektor kami. Kami juga menggunakan admin vektor untuk melihat dokumen yang tertelan. Untuk menggunakan vektor admin, cukup jalankan perintah ini:

docker compose up vector-admin -d

Perintah ini memulai vektor-admin di port 3001. Pergilah ke http: // localhost: 3001 dan konfigurasikan chromadb lokal Anda. Catatan: Karena vektor-admin berjalan di dalam wadah Docker, di bidang "Host" pastikan untuk memasukkan http://host.docker.internal:8000 bukan http://localhost:8000 . Ini karena "LocalHost" tidak merujuk pada host di dalam wadah itu sendiri.

Selain itu, di "API Header & Key", Anda harus menempatkan "X-Chroma-Token" sebagai header dan nilainya di dalam .env CHROMA_SERVER_AUTHN_CREDENTIALS sebagai nilainya.

Untuk mempelajari cara menggunakan vektoradmin, kunjungi dokumen.

Dukungan dan Umpan Balik? ‍️

Dalam urutan preferensi cara terbaik untuk berkomunikasi dengan kami:

• Diskusi GitHub : Kontribusi ide, permintaan dukungan dan bug laporan (lebih disukai karena ada statis & permanen untuk anggota masyarakat lainnya).
• Slack : Dukungan Komunitas. Klik di sini untuk bergabung.
• Secara pribadi : Hubungi di [email protected]

Berkontribusi pada Vespper ⛑️

Jika Anda tertarik untuk berkontribusi pada Vespper, periksa file CONTRIBUTING.md kami? ? ‍♂️

Pemecahan masalah ⚒️

Jika Anda menghadapi masalah/kesalahan/masalah dengan Vespper, lihat panduan pemecahan masalah kami. Kami mencoba memperbaruinya secara teratur, dan memperbaiki beberapa masalah mendesak di sana sesegera mungkin.

Selain itu, jangan ragu untuk menjangkau kami di saluran dukungan kami.

Telemetri?

Secara default, Vespper secara otomatis mengirimkan statistik penggunaan dasar dari instance yang diselenggarakan sendiri ke server kami melalui posthog.

Ini memungkinkan kita untuk:

• Pahami bagaimana vespper digunakan sehingga kami dapat memperbaikinya.
• Lacak penggunaan keseluruhan untuk tujuan internal dan pelaporan eksternal, seperti untuk penggalangan dana.

Yakinlah, data yang dikumpulkan tidak dibagikan dengan pihak ketiga dan tidak termasuk informasi sensitif apa pun. Kami bertujuan untuk menjadi transparan, dan Anda dapat meninjau data spesifik yang kami kumpulkan di sini.

Jika Anda lebih suka untuk tidak berpartisipasi, Anda dapat dengan mudah memilih keluar dengan mengatur TELEMETRY_ENABLED=false di dalam .env Anda.

Lisensi?

Proyek ini dilisensikan di bawah lisensi Apache 2.0 - lihat file lisensi untuk detailnya

Pelajari lebih lanjut?

Lihatlah situs web resmi di https://vespper.com untuk informasi lebih lanjut.

Kontributor

Dibangun dengan ❤️ oleh Dudu & Topaz

Dudu: GitHub, Twitter

Topaz: GitHub, Twitter