banko-ai-assistant 1.0.16__py3-none-any.whl → 1.0.17__py3-none-any.whl

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
banko_ai/cli.py CHANGED
@@ -260,6 +260,12 @@ def help():
260
260
 
261
261
  This is a modern AI-powered expense analysis application with RAG capabilities.
262
262
 
263
+ PREREQUISITES:
264
+ --------------
265
+ - CockroachDB v25.2.4+ (recommended: v25.3.1)
266
+ - Vector index feature enabled: SET CLUSTER SETTING feature.vector_index.enabled = true;
267
+ - Start single node: cockroach start-single-node --insecure --store=./cockroach-data --listen-addr=localhost:26257 --http-addr=localhost:8080 --background
268
+
263
269
  QUICK START:
264
270
  -----------
265
271
  1. Set up your environment variables:
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: banko-ai-assistant
3
- Version: 1.0.16
3
+ Version: 1.0.17
4
4
  Summary: AI-powered expense analysis and RAG system with CockroachDB vector search and multi-provider AI support
5
5
  Author-email: Virag Tripathi <virag.tripathi@gmail.com>
6
6
  License-Expression: MIT
@@ -30,9 +30,9 @@ Requires-Dist: jinja2<4.0.0,>=3.1.0
30
30
  Requires-Dist: psycopg2-binary<3.0.0,>=2.9.0
31
31
  Requires-Dist: sqlalchemy<3.0.0,>=2.0.0
32
32
  Requires-Dist: sqlalchemy-cockroachdb<3.0.0,>=2.0.0
33
- Requires-Dist: sentence-transformers<3.0.0,>=2.2.0
34
- Requires-Dist: boto3<1.35.0,>=1.34.0
35
- Requires-Dist: botocore<1.35.0,>=1.34.0
33
+ Requires-Dist: sentence-transformers<4.0.0,>=3.1.0
34
+ Requires-Dist: boto3<1.41.0,>=1.40.0
35
+ Requires-Dist: botocore<1.41.0,>=1.40.0
36
36
  Requires-Dist: openai<2.0.0,>=1.11.0
37
37
  Requires-Dist: requests<3.0.0,>=2.32.4
38
38
  Requires-Dist: numpy<2.0.0,>=1.26.0
@@ -76,9 +76,48 @@ A modern AI-powered expense analysis application with Retrieval-Augmented Genera
76
76
 
77
77
  ### Prerequisites
78
78
 
79
- - Python 3.8+
80
- - CockroachDB (running locally or cloud)
81
- - AI Provider API Key (OpenAI, AWS, IBM Watsonx, or Google Gemini)
79
+ - **Python 3.8+**
80
+ - **CockroachDB v25.2.4+** (recommended: [v25.3.1](https://www.cockroachlabs.com/docs/releases/v25.3#v25-3-1))
81
+ - **Vector Index Feature Enabled** (required for vector search)
82
+ - **AI Provider API Key** (OpenAI, AWS, IBM Watsonx, or Google Gemini)
83
+
84
+ #### CockroachDB Setup
85
+
86
+ 1. **Download and Install CockroachDB**:
87
+ ```bash
88
+ # Download CockroachDB v25.3.1 (recommended)
89
+ # Visit: https://www.cockroachlabs.com/docs/releases/v25.3#v25-3-1
90
+
91
+ # Or install via package manager
92
+ brew install cockroachdb/tap/cockroach # macOS
93
+ ```
94
+
95
+ 2. **Start CockroachDB Single Node**:
96
+ ```bash
97
+ # Start a single-node cluster (for development)
98
+ cockroach start-single-node \
99
+ --insecure \
100
+ --store=./cockroach-data \
101
+ --listen-addr=localhost:26257 \
102
+ --http-addr=localhost:8080 \
103
+ --background
104
+ ```
105
+
106
+ 3. **Enable Vector Index Feature**:
107
+ ```sql
108
+ -- Connect to the database
109
+ cockroach sql --url="cockroachdb://root@localhost:26257/defaultdb?sslmode=disable"
110
+
111
+ -- Enable vector index feature (required for vector search)
112
+ SET CLUSTER SETTING feature.vector_index.enabled = true;
113
+ ```
114
+
115
+ 4. **Verify Setup**:
116
+ ```sql
117
+ -- Check if vector index is enabled
118
+ SHOW CLUSTER SETTING feature.vector_index.enabled;
119
+ -- Should return: true
120
+ ```
82
121
 
83
122
  ### Installation
84
123
 
@@ -94,7 +133,7 @@ export WATSONX_MODEL_ID="openai/gpt-oss-120b"
94
133
  export DATABASE_URL="cockroachdb://root@localhost:26257/defaultdb?sslmode=disable"
95
134
 
96
135
  # Run the application
97
- python -m banko_ai
136
+ python -m banko-ai
98
137
  ```
99
138
 
100
139
  #### Option 2: Development Installation
@@ -230,14 +269,14 @@ banko-ai help
230
269
 
231
270
  ## 🔌 API Endpoints
232
271
 
233
- | Endpoint | Method | Description |
234
- |----------|--------|-------------|
235
- | `/` | GET | Web interface |
236
- | `/api/health` | GET | System health check |
237
- | `/api/ai-providers` | GET | Available AI providers |
238
- | `/api/models` | GET | Available models for current provider |
239
- | `/api/search` | POST | Vector search expenses |
240
- | `/api/rag` | POST | RAG-based Q&A |
272
+ | Endpoint | Method | Description |
273
+ |---------------------|--------|---------------------------------------|
274
+ | `/` | GET | Web interface |
275
+ | `/api/health` | GET | System health check |
276
+ | `/api/ai-providers` | GET | Available AI providers |
277
+ | `/api/models` | GET | Available models for current provider |
278
+ | `/api/search` | POST | Vector search expenses |
279
+ | `/api/rag` | POST | RAG-based Q&A |
241
280
 
242
281
  ### API Examples
243
282
 
@@ -366,10 +405,36 @@ banko_ai/
366
405
 
367
406
  ### Common Issues
368
407
 
408
+ **CockroachDB Version Issues**
409
+ ```bash
410
+ # Check CockroachDB version (must be v25.2.4+)
411
+ cockroach version
412
+
413
+ # If version is too old, download v25.3.1:
414
+ # https://www.cockroachlabs.com/docs/releases/v25.3#v25-3-1
415
+ ```
416
+
417
+ **Vector Index Feature Not Enabled**
418
+ ```bash
419
+ # Connect to database and enable vector index feature
420
+ cockroach sql --url="cockroachdb://root@localhost:26257/defaultdb?sslmode=disable"
421
+
422
+ # Enable vector index feature
423
+ SET CLUSTER SETTING feature.vector_index.enabled = true;
424
+
425
+ # Verify it's enabled
426
+ SHOW CLUSTER SETTING feature.vector_index.enabled;
427
+ ```
428
+
369
429
  **Database Connection Error**
370
430
  ```bash
371
- # Check CockroachDB is running
372
- cockroach start --insecure --listen-addr=localhost:26257
431
+ # Start CockroachDB single node
432
+ cockroach start-single-node \
433
+ --insecure \
434
+ --store=./cockroach-data \
435
+ --listen-addr=localhost:26257 \
436
+ --http-addr=localhost:8080 \
437
+ --background
373
438
 
374
439
  # Verify database exists
375
440
  cockroach sql --url="cockroachdb://root@localhost:26257/defaultdb?sslmode=disable" --execute "SHOW TABLES;"
@@ -417,4 +482,4 @@ For issues and questions:
417
482
 
418
483
  ---
419
484
 
420
- **Built with ❤️ using CockroachDB, Flask, and modern AI technologies**
485
+ **Built with ❤️ using CockroachDB, Flask, and modern AI technologies such as **
@@ -1,6 +1,6 @@
1
1
  banko_ai/__init__.py,sha256=G1InyKemqQxP9xx6yGZgolBmrmOLSpBXqGYY8LaFOeo,568
2
2
  banko_ai/__main__.py,sha256=U-KkrXtL8JNIyV25PE5v_eYhlhjR7jd6kG-txfYfs0M,709
3
- banko_ai/cli.py,sha256=7lMeDRIuJjeAkrVMzw2YmJp4t10KLGP7TRIywUSOkeU,13884
3
+ banko_ai/cli.py,sha256=goTkY3qhTrGvmERbapKztYH-g7fAemxThZJSO7Ll2HI,14205
4
4
  banko_ai/ai_providers/__init__.py,sha256=JdBgw5Mji2pe9nU-aiRYUmJuZk0q8KbcMtbpMJC5Dq8,483
5
5
  banko_ai/ai_providers/aws_provider.py,sha256=-tR-8tlEeSL-Fspx05tTMFguvQylkW_pz0PI2XJEByM,13074
6
6
  banko_ai/ai_providers/base.py,sha256=zbuAgkHIfJ0YkG83LXzieJuvXBcB2-nx7NhbL-I4Pf0,4725
@@ -156,9 +156,9 @@ banko_ai/vector_search/search.py,sha256=RiDxqcRblAFSmxMvxy9nRRrw22OtVMHP5_rsvQsS
156
156
  banko_ai/web/__init__.py,sha256=hjWVVxYpIZhOAN1qBf4xTd36a5AUHM03Q8BF8pykhJQ,363
157
157
  banko_ai/web/app.py,sha256=Temx39TX19idHrlrUwb_2QLr1GSZZVjqhyJC299NFMY,32145
158
158
  banko_ai/web/auth.py,sha256=js6qIixSFHyLbETDm8GNLCPrDkCDcaQZPFOrqtZP1uw,2125
159
- banko_ai_assistant-1.0.16.dist-info/licenses/LICENSE,sha256=skG0LkywIClj8fgSIXiG6o9vUDJ678BKBObIyJ19OMw,1075
160
- banko_ai_assistant-1.0.16.dist-info/METADATA,sha256=BuVSoi6etHKRv2qq6rLW5FucRSzlUSuZip87XXi0y-g,13505
161
- banko_ai_assistant-1.0.16.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
162
- banko_ai_assistant-1.0.16.dist-info/entry_points.txt,sha256=IxPjBjMvbpCp-ikCA43bOSbYboTGPX4HYcZlvu2_vcA,47
163
- banko_ai_assistant-1.0.16.dist-info/top_level.txt,sha256=xNMa9Z67UssefOQ2ubFObtqUYIfYmCIclfz0xdo5OPE,9
164
- banko_ai_assistant-1.0.16.dist-info/RECORD,,
159
+ banko_ai_assistant-1.0.17.dist-info/licenses/LICENSE,sha256=skG0LkywIClj8fgSIXiG6o9vUDJ678BKBObIyJ19OMw,1075
160
+ banko_ai_assistant-1.0.17.dist-info/METADATA,sha256=s8CC5JnedQVmaO-rZgulNvFekvxR1KYcUsbYysVzdoY,15573
161
+ banko_ai_assistant-1.0.17.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
162
+ banko_ai_assistant-1.0.17.dist-info/entry_points.txt,sha256=IxPjBjMvbpCp-ikCA43bOSbYboTGPX4HYcZlvu2_vcA,47
163
+ banko_ai_assistant-1.0.17.dist-info/top_level.txt,sha256=xNMa9Z67UssefOQ2ubFObtqUYIfYmCIclfz0xdo5OPE,9
164
+ banko_ai_assistant-1.0.17.dist-info/RECORD,,