Al-Fathir commited on
Commit
52d49a3
·
1 Parent(s): 6161919

feat : add readme and example env

Browse files
Files changed (2) hide show
  1. .env.example +3 -0
  2. README.md +68 -10
.env.example ADDED
@@ -0,0 +1,3 @@
 
 
 
 
1
+ HUGGINGFACE_TOKEN=your-secret-key
2
+ DATABASE_URL=your-database-url
3
+ SECRET_KEY=your-secret-key
README.md CHANGED
@@ -1,13 +1,71 @@
 
 
1
  ---
2
- title: Chatsql
3
- emoji: 🔥
4
- colorFrom: purple
5
- colorTo: green
6
- sdk: gradio
7
- sdk_version: 5.13.2
8
- app_file: app.py
9
- pinned: false
10
- short_description: This chatbot can access your database directly
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
11
  ---
12
 
13
- Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference
 
1
+ Berikut adalah contoh README yang dapat digunakan untuk proyek ChatSQL:
2
+
3
  ---
4
+
5
+ # ChatSQL
6
+
7
+ ChatSQL adalah aplikasi chatbot yang dapat berinteraksi langsung dengan basis data Anda. Dengan menggunakan antarmuka percakapan, ChatSQL memungkinkan pengguna untuk mengajukan pertanyaan dalam bahasa alami dan mendapatkan jawaban langsung dari basis data tanpa perlu menulis kueri SQL secara manual.
8
+
9
+ ## Fitur
10
+
11
+ - **Interaksi Bahasa Alami**: Ajukan pertanyaan dalam bahasa sehari-hari tanpa perlu memahami sintaks SQL.
12
+ - **Akses Basis Data Langsung**: Chatbot dapat mengakses dan mengambil data langsung dari basis data Anda.
13
+ - **Antarmuka Pengguna Interaktif**: Dilengkapi dengan antarmuka berbasis web yang ramah pengguna menggunakan Gradio.
14
+
15
+ ## Instalasi
16
+
17
+ 1. **Kloning repositori ini**:
18
+
19
+ ```bash
20
+ git clone https://github.com/Alfthrpy/chatsql.git
21
+ cd chatsql
22
+ ```
23
+
24
+ 2. **Buat dan aktifkan lingkungan virtual**:
25
+
26
+ ```bash
27
+ python -m venv env
28
+ source env/bin/activate # Untuk Windows, gunakan 'env\Scripts\activate'
29
+ ```
30
+
31
+ 3. **Instal dependensi**:
32
+
33
+ ```bash
34
+ pip install -r requirements.txt
35
+ ```
36
+
37
+ ## Konfigurasi
38
+
39
+ 1. **Pengaturan Basis Data**: Pastikan Anda memiliki basis data yang dapat diakses oleh ChatSQL. Perbarui parameter koneksi basis data sesuai kebutuhan Anda di file konfigurasi atau langsung dalam kode.
40
+
41
+ 2. **Kunci API Huggingface**: Jika Anda menggunakan model bahasa dari Huggingface untuk pemrosesan bahasa alami, pastikan untuk menyertakan kunci API Anda dalam file konfigurasi atau sebagai variabel lingkungan.
42
+
43
+ ## Penggunaan
44
+
45
+ 1. **Jalankan aplikasi**:
46
+
47
+ ```bash
48
+ python app.py
49
+ ```
50
+
51
+ 2. **Akses antarmuka pengguna**: Buka browser Anda dan navigasikan ke URL yang ditampilkan di terminal (biasanya `http://127.0.0.1:7860/`).
52
+
53
+ 3. **Mulai berinteraksi**: Gunakan antarmuka untuk mengajukan pertanyaan dalam bahasa alami dan dapatkan jawaban langsung dari basis data Anda.
54
+
55
+ ## Struktur Proyek
56
+
57
+ - `app.py`: Skrip utama untuk menjalankan aplikasi Gradio.
58
+ - `agents.py`: Berisi agen atau logika untuk memproses input pengguna dan berinteraksi dengan basis data.
59
+ - `requirements.txt`: Daftar dependensi Python yang diperlukan untuk menjalankan aplikasi.
60
+
61
+ ## Kontribusi
62
+
63
+ Kontribusi sangat diterima! Silakan fork repositori ini dan ajukan pull request untuk perbaikan atau fitur baru.
64
+
65
+ ## Lisensi
66
+
67
+ Proyek ini dilisensikan di bawah lisensi MIT.
68
+
69
  ---
70
 
71
+ Catatan: Pastikan untuk mengganti bagian konfigurasi dengan detail spesifik sesuai dengan kebutuhan dan lingkungan Anda.