jupyter ai

Jupyter AI

Jupyter AI sedang dalam masa inkubasi sebagai bagian dari organisasi JupyterLab.

Jupyter AI menghubungkan AI generatif dengan notebook Jupyter. Jupyter AI menyediakan cara yang mudah digunakan dan canggih untuk menjelajahi model AI generatif di notebook dan meningkatkan produktivitas Anda di JupyterLab dan Jupyter Notebook. Lebih khusus lagi, Jupyter AI menawarkan:

• Keajaiban %%ai yang mengubah notebook Jupyter menjadi taman bermain AI generatif yang dapat direproduksi. Ini berfungsi di mana pun kernel IPython dijalankan (JupyterLab, Jupyter Notebook, Google Colab, Kaggle, VSCode, dll.).
• UI obrolan asli di JupyterLab yang memungkinkan Anda bekerja dengan AI generatif sebagai asisten percakapan.
• Dukungan untuk berbagai penyedia model generatif, termasuk AI21, Anthropic, AWS, Cohere, Gemini, Hugging Face, MistralAI, NVIDIA, dan OpenAI.
• Dukungan model lokal melalui GPT4All dan Ollama, memungkinkan penggunaan model AI generatif pada mesin tingkat konsumen dengan mudah dan privasi.

Dokumentasi tersedia di ReadTheDocs.

Persyaratan

Anda harus menginstal perangkat lunak berikut untuk menggunakan Jupyter AI:

• Python 3.8 - 3.12
• JupyterLab 4 atau Buku Catatan 7

Selain itu, Anda memerlukan akses ke setidaknya satu penyedia model.

Penting

JupyterLab 3 mencapai akhir tanggal pemeliharaan pada 15 Mei 2024. Oleh karena itu, kami tidak akan melakukan backport fitur baru ke cabang v1 yang mendukung JupyterLab 3. Perbaikan untuk masalah kritis akan tetap di-backport hingga 31 Desember 2024. Jika Anda masih melakukan backport menggunakan JupyterLab 3, kami sangat menganjurkan Anda untuk meningkatkan ke JupyterLab 4 sesegera mungkin . Untuk informasi lebih lanjut, lihat akhir pemeliharaan JupyterLab 3 di Blog Jupyter.

Menyiapkan Penyedia Model di Notebook

Untuk menggunakan penyedia model AI apa pun dalam notebook ini, Anda memerlukan kredensial yang sesuai, seperti kunci API.

Dapatkan kredensial yang diperlukan, seperti kunci API, dari platform penyedia model Anda.

Anda dapat mengatur kunci Anda menggunakan variabel lingkungan atau dalam sel kode di buku catatan Anda. Di sel kode, Anda dapat menggunakan perintah ajaib %env untuk mengatur kredensial sebagai berikut:

 # NOTE: Replace 'PROVIDER_API_KEY' with the credential key's name,
# and replace 'YOUR_API_KEY_HERE' with the key.
% env PROVIDER_API_KEY = YOUR_API_KEY_HERE

Untuk instruksi yang lebih spesifik untuk setiap penyedia model, lihat dokumentasi penyedia model.

Instalasi

Di bawah ini adalah ikhtisar sederhana tentang proses instalasi dan penggunaan. Lihat dokumentasi resmi kami untuk detail tentang cara menginstal dan menggunakan Jupyter AI.

Kami menawarkan 3 cara berbeda untuk menginstal Jupyter AI. Anda dapat membaca setiap bagian untuk memilih metode instalasi yang paling sesuai untuk Anda.

1. Instalasi cepat melalui pip (disarankan)
2. Instalasi minimal melalui pip
3. Instalasi minimal melalui conda

Instalasi cepat melalui pip (disarankan)

Jika Anda ingin menginstal %%ai magic dan ekstensi JupyterLab, Anda dapat menjalankan:

 $ pip install jupyter-ai[all]

Kemudian, mulai ulang JupyterLab. Ini akan menginstal setiap ketergantungan opsional, yang menyediakan akses ke semua model yang saat ini didukung oleh jupyter-ai .

Jika Anda tidak menggunakan JupyterLab dan hanya ingin menginstal keajaiban Jupyter AI %%ai , Anda dapat menjalankan:

 $ pip install jupyter-ai-magics[all]

jupyter-ai bergantung pada jupyter-ai-magics , jadi menginstal jupyter-ai secara otomatis menginstal jupyter-ai-magics .

Instalasi minimal melalui pip

Sebagian besar penyedia model di Jupyter AI memerlukan penginstalan dependensi tertentu sebelum tersedia untuk digunakan. Ini disebut ketergantungan penyedia . Dependensi penyedia bersifat opsional untuk Jupyter AI, artinya Jupyter AI dapat diinstal dengan atau tanpa dependensi penyedia apa pun yang diinstal. Jika penyedia memerlukan ketergantungan yang tidak diinstal, modelnya tidak tercantum dalam antarmuka pengguna yang memungkinkan Anda memilih model bahasa.

Untuk melakukan instalasi minimal melalui pip tanpa ketergantungan penyedia apa pun, hilangkan grup ketergantungan opsional [all] dari nama paket:

 pip install jupyter-ai

Dengan menginstal dependensi penyedia secara selektif, Anda dapat mengontrol model mana yang tersedia di lingkungan Jupyter AI Anda.

Misalnya, untuk menginstal Jupyter AI dengan hanya dukungan tambahan untuk model Anthropic, jalankan:

 pip install jupyter-ai langchain-anthropic

Untuk informasi selengkapnya tentang penyedia model dan dependensi mana yang diperlukan, lihat tabel penyedia model.

Instalasi minimal melalui conda

Sebagai alternatif untuk menggunakan pip , Anda dapat menginstal jupyter-ai menggunakan Conda dari saluran conda-forge :

 $ conda install conda-forge::jupyter-ai

Sebagian besar penyedia model di Jupyter AI memerlukan dependensi penyedia tertentu untuk diinstal sebelum tersedia untuk digunakan. Ketergantungan penyedia tidak diinstal saat menginstal jupyter-ai dari Conda Forge, dan harus diinstal secara terpisah sesuai kebutuhan.

Misalnya, untuk menginstal Jupyter AI dengan hanya dukungan tambahan untuk model OpenAI, jalankan:

 conda install conda-forge::jupyter-ai conda-forge::langchain-openai

Untuk informasi selengkapnya tentang penyedia model dan dependensi mana yang diperlukan, lihat tabel penyedia model.

Perintah ajaib %%ai

Keajaiban %%ai berfungsi di mana pun kernel IPython dijalankan, termasuk JupyterLab, Jupyter Notebook, Google Colab, dan Visual Studio Code.

Setelah Anda menginstal keajaiban %%ai , Anda dapat mengaktifkannya di notebook atau shell IPython mana pun dengan menjalankan:

 %load_ext jupyter_ai_magics

atau:

 %load_ext jupyter_ai

Tangkapan layar di bawah berasal dari buku catatan di direktori examples/ paket ini.

Kemudian, Anda dapat menggunakan perintah ajaib %%ai untuk menentukan model dan perintah bahasa alami:

Jupyter AI juga dapat menghasilkan HTML dan matematika untuk dirender sebagai keluaran sel.

Jupyter AI dapat menginterpolasi ekspresi IPython, memungkinkan Anda menjalankan perintah yang menyertakan nilai variabel.

Ekstensi JupyterLab

Ekstensi Jupyter AI untuk JupyterLab menawarkan UI asli yang memungkinkan banyak pengguna mengobrol dengan asisten percakapan Jupyter AI. Jika Anda telah menginstal JupyterLab, ini harus diinstal dan diaktifkan ketika Anda menginstal paket jupyter_ai .

Menggunakan

Untuk bantuan dalam menginstal dan menggunakan Jupyter AI, silakan lihat dokumentasi pengguna kami di ReadTheDocs.

Berkontribusi

Jika Anda ingin berkontribusi pada Jupyter AI, lihat dokumentasi kontributor kami di ReadTheDocs.