Spaces:
Configuration error
Configuration error
Al-Fathir
commited on
Commit
·
52d49a3
1
Parent(s):
6161919
feat : add readme and example env
Browse files- .env.example +3 -0
- 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 |
-
|
3 |
-
|
4 |
-
|
5 |
-
|
6 |
-
|
7 |
-
|
8 |
-
|
9 |
-
|
10 |
-
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
11 |
---
|
12 |
|
13 |
-
|
|
|
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.
|