solvedesk-ai 0.1.0__tar.gz

solvedesk_ai-0.1.0/PKG-INFO

@@ -0,0 +1,251 @@
+Metadata-Version: 2.4
+Name: solvedesk-ai
+Version: 0.1.0
+Summary: Local RAG framework for building intelligent knowledge bases
+Author: Dominik Hofman
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+Requires-Dist: typer
+Requires-Dist: fastapi
+Requires-Dist: chromadb
+Requires-Dist: sentence-transformers
+Requires-Dist: python-dotenv
+
+# SolveDesk AI
+
+Intelligent knowledge base powered by embeddings, vector search and Retrieval-Augmented Generation (RAG).
+
+## Overview
+
+SolveDesk AI is a lightweight open-source framework for building local intelligent knowledge bases. The project provides a command-line interface for creating vector databases, importing documents, generating embeddings, performing semantic search, and integrating with local Large Language Models (LLMs).
+
+Inspired by frameworks such as Laravel and Django, SolveDesk AI simplifies the process of building Retrieval-Augmented Generation (RAG) systems by providing ready-to-use commands and a modular architecture.
+
+The framework can be used both as a production-ready knowledge base solution and as an educational platform for learning modern AI technologies, vector databases, embeddings, and semantic retrieval.
+
+---
+
+## Features
+
+* Local knowledge base creation
+* Semantic document search
+* Retrieval-Augmented Generation (RAG)
+* Vector database management
+* Embedding generation
+* Local LLM integration through Ollama
+* Data synchronization from APIs
+* CSV, JSON and XLSX import support
+* Embedding quality analysis
+* Document chunking
+* FastAPI integration
+* Command-line interface
+
+---
+
+## Architecture
+
+```text
+Documents / API
+       │
+       ▼
+Embedding Model
+       │
+       ▼
+    ChromaDB
+       │
+       ▼
+Semantic Search
+       │
+       ▼
+      LLM
+    Ollama
+       │
+       ▼
+ Generated Response
+```
+
+---
+
+## Technologies
+
+| Technology               | Purpose                |
+| ------------------------ | ---------------------- |
+| Python 3.11              | Application runtime    |
+| FastAPI                  | REST API               |
+| ChromaDB                 | Vector database        |
+| silver-retriever-base-v1 | Embedding model        |
+| Sentence Transformers    | Embedding generation   |
+| Ollama                   | Local LLM integration  |
+| Matplotlib               | Data visualization     |
+| Typer                    | Command-line interface |
+
+---
+
+## Installation
+
+Clone repository:
+
+```bash
+git clone https://github.com/your-repository/solvedesk-ai.git
+cd solvedesk-ai
+```
+
+Install dependencies:
+
+```bash
+pip install -r requirements.txt
+```
+
+Initialize project:
+
+```bash
+solvedesk conf init
+```
+
+Initialize vector database:
+
+```bash
+solvedesk db init
+```
+
+Configure local LLM:
+
+```bash
+solvedesk llm init
+```
+
+---
+
+## CLI Commands
+
+### Project Configuration
+
+```bash
+solvedesk conf init
+```
+
+Initialize project environment.
+
+### Database
+
+```bash
+solvedesk db init
+```
+
+Create vector database and download embedding model.
+
+```bash
+solvedesk db list
+```
+
+Display available collections.
+
+```bash
+solvedesk db details COLLECTION_NAME
+```
+
+Display collection details.
+
+### Data Synchronization
+
+```bash
+solvedesk sync api
+```
+
+Import documents from external API.
+
+```bash
+solvedesk sync file
+```
+
+Import documents from CSV, JSON or XLSX files.
+
+### Data Analysis
+
+```bash
+solvedesk data revision
+```
+
+Generate reports containing:
+
+* cosine similarity statistics
+* cluster distribution
+* token statistics
+* PCA visualization
+
+### Chunking
+
+```bash
+solvedesk data chunk
+```
+
+Split large documents into smaller chunks suitable for RAG systems.
+
+### LLM Configuration
+
+```bash
+solvedesk llm init
+```
+
+Configure Ollama host and model.
+
+### Run Application
+
+```bash
+solvedesk run:app
+```
+
+Start FastAPI server.
+
+---
+
+## Supported Data Structures
+
+### FAQ
+
+```json
+{
+  "question": "How to reset password?",
+  "answer": "Use reset password page."
+}
+```
+
+### Knowledge Base
+
+```json
+{
+  "name": "VPN Connection",
+  "question": "Cannot connect to VPN",
+  "answer": "Verify credentials and VPN client configuration."
+}
+```
+
+---
+
+## Example Workflow
+
+```bash
+solvedesk conf init
+solvedesk db init
+solvedesk sync file
+solvedesk data revision
+solvedesk llm init
+solvedesk run:app
+```
+
+---
+
+## Project Goals
+
+* Build local intelligent knowledge bases
+* Simplify RAG implementation
+* Support AI experimentation
+* Provide full control over data
+* Enable local LLM deployments
+* Offer educational value for learning AI technologies
+
+---
+
+## License
+
+MIT License

solvedesk_ai-0.1.0/README.md

@@ -0,0 +1,238 @@
+# SolveDesk AI
+
+Intelligent knowledge base powered by embeddings, vector search and Retrieval-Augmented Generation (RAG).
+
+## Overview
+
+SolveDesk AI is a lightweight open-source framework for building local intelligent knowledge bases. The project provides a command-line interface for creating vector databases, importing documents, generating embeddings, performing semantic search, and integrating with local Large Language Models (LLMs).
+
+Inspired by frameworks such as Laravel and Django, SolveDesk AI simplifies the process of building Retrieval-Augmented Generation (RAG) systems by providing ready-to-use commands and a modular architecture.
+
+The framework can be used both as a production-ready knowledge base solution and as an educational platform for learning modern AI technologies, vector databases, embeddings, and semantic retrieval.
+
+---
+
+## Features
+
+* Local knowledge base creation
+* Semantic document search
+* Retrieval-Augmented Generation (RAG)
+* Vector database management
+* Embedding generation
+* Local LLM integration through Ollama
+* Data synchronization from APIs
+* CSV, JSON and XLSX import support
+* Embedding quality analysis
+* Document chunking
+* FastAPI integration
+* Command-line interface
+
+---
+
+## Architecture
+
+```text
+Documents / API
+       │
+       ▼
+Embedding Model
+       │
+       ▼
+    ChromaDB
+       │
+       ▼
+Semantic Search
+       │
+       ▼
+      LLM
+    Ollama
+       │
+       ▼
+ Generated Response
+```
+
+---
+
+## Technologies
+
+| Technology               | Purpose                |
+| ------------------------ | ---------------------- |
+| Python 3.11              | Application runtime    |
+| FastAPI                  | REST API               |
+| ChromaDB                 | Vector database        |
+| silver-retriever-base-v1 | Embedding model        |
+| Sentence Transformers    | Embedding generation   |
+| Ollama                   | Local LLM integration  |
+| Matplotlib               | Data visualization     |
+| Typer                    | Command-line interface |
+
+---
+
+## Installation
+
+Clone repository:
+
+```bash
+git clone https://github.com/your-repository/solvedesk-ai.git
+cd solvedesk-ai
+```
+
+Install dependencies:
+
+```bash
+pip install -r requirements.txt
+```
+
+Initialize project:
+
+```bash
+solvedesk conf init
+```
+
+Initialize vector database:
+
+```bash
+solvedesk db init
+```
+
+Configure local LLM:
+
+```bash
+solvedesk llm init
+```
+
+---
+
+## CLI Commands
+
+### Project Configuration
+
+```bash
+solvedesk conf init
+```
+
+Initialize project environment.
+
+### Database
+
+```bash
+solvedesk db init
+```
+
+Create vector database and download embedding model.
+
+```bash
+solvedesk db list
+```
+
+Display available collections.
+
+```bash
+solvedesk db details COLLECTION_NAME
+```
+
+Display collection details.
+
+### Data Synchronization
+
+```bash
+solvedesk sync api
+```
+
+Import documents from external API.
+
+```bash
+solvedesk sync file
+```
+
+Import documents from CSV, JSON or XLSX files.
+
+### Data Analysis
+
+```bash
+solvedesk data revision
+```
+
+Generate reports containing:
+
+* cosine similarity statistics
+* cluster distribution
+* token statistics
+* PCA visualization
+
+### Chunking
+
+```bash
+solvedesk data chunk
+```
+
+Split large documents into smaller chunks suitable for RAG systems.
+
+### LLM Configuration
+
+```bash
+solvedesk llm init
+```
+
+Configure Ollama host and model.
+
+### Run Application
+
+```bash
+solvedesk run:app
+```
+
+Start FastAPI server.
+
+---
+
+## Supported Data Structures
+
+### FAQ
+
+```json
+{
+  "question": "How to reset password?",
+  "answer": "Use reset password page."
+}
+```
+
+### Knowledge Base
+
+```json
+{
+  "name": "VPN Connection",
+  "question": "Cannot connect to VPN",
+  "answer": "Verify credentials and VPN client configuration."
+}
+```
+
+---
+
+## Example Workflow
+
+```bash
+solvedesk conf init
+solvedesk db init
+solvedesk sync file
+solvedesk data revision
+solvedesk llm init
+solvedesk run:app
+```
+
+---
+
+## Project Goals
+
+* Build local intelligent knowledge bases
+* Simplify RAG implementation
+* Support AI experimentation
+* Provide full control over data
+* Enable local LLM deployments
+* Offer educational value for learning AI technologies
+
+---
+
+## License
+
+MIT License

solvedesk_ai-0.1.0/pyproject.toml

@@ -0,0 +1,23 @@
+[build-system]
+requires = ["setuptools>=69", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "solvedesk-ai"
+version = "0.1.0"
+description = "Local RAG framework for building intelligent knowledge bases"
+readme = "README.md"
+requires-python = ">=3.10"
+authors = [
+  { name = "Dominik Hofman" }
+]
+dependencies = [
+  "typer",
+  "fastapi",
+  "chromadb",
+  "sentence-transformers",
+  "python-dotenv"
+]
+
+[project.scripts]
+solvedesk = "solvedesk.cli:app"

solvedesk_ai-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

solvedesk_ai-0.1.0/setup.py

@@ -0,0 +1,19 @@
+from setuptools import setup, find_packages
+
+setup(
+    name="solvedesk",
+    version="1.0.0",
+
+    packages=find_packages(),
+
+    install_requires=[
+        "typer",
+        "rich"
+    ],
+
+    entry_points={
+        "console_scripts": [
+            "solvedesk=solvedesk_cmd.cmd:app"
+        ]
+    }
+)

solvedesk_ai-0.1.0/solvedesk_ai.egg-info/PKG-INFO

@@ -0,0 +1,251 @@
+Metadata-Version: 2.4
+Name: solvedesk-ai
+Version: 0.1.0
+Summary: Local RAG framework for building intelligent knowledge bases
+Author: Dominik Hofman
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+Requires-Dist: typer
+Requires-Dist: fastapi
+Requires-Dist: chromadb
+Requires-Dist: sentence-transformers
+Requires-Dist: python-dotenv
+
+# SolveDesk AI
+
+Intelligent knowledge base powered by embeddings, vector search and Retrieval-Augmented Generation (RAG).
+
+## Overview
+
+SolveDesk AI is a lightweight open-source framework for building local intelligent knowledge bases. The project provides a command-line interface for creating vector databases, importing documents, generating embeddings, performing semantic search, and integrating with local Large Language Models (LLMs).
+
+Inspired by frameworks such as Laravel and Django, SolveDesk AI simplifies the process of building Retrieval-Augmented Generation (RAG) systems by providing ready-to-use commands and a modular architecture.
+
+The framework can be used both as a production-ready knowledge base solution and as an educational platform for learning modern AI technologies, vector databases, embeddings, and semantic retrieval.
+
+---
+
+## Features
+
+* Local knowledge base creation
+* Semantic document search
+* Retrieval-Augmented Generation (RAG)
+* Vector database management
+* Embedding generation
+* Local LLM integration through Ollama
+* Data synchronization from APIs
+* CSV, JSON and XLSX import support
+* Embedding quality analysis
+* Document chunking
+* FastAPI integration
+* Command-line interface
+
+---
+
+## Architecture
+
+```text
+Documents / API
+       │
+       ▼
+Embedding Model
+       │
+       ▼
+    ChromaDB
+       │
+       ▼
+Semantic Search
+       │
+       ▼
+      LLM
+    Ollama
+       │
+       ▼
+ Generated Response
+```
+
+---
+
+## Technologies
+
+| Technology               | Purpose                |
+| ------------------------ | ---------------------- |
+| Python 3.11              | Application runtime    |
+| FastAPI                  | REST API               |
+| ChromaDB                 | Vector database        |
+| silver-retriever-base-v1 | Embedding model        |
+| Sentence Transformers    | Embedding generation   |
+| Ollama                   | Local LLM integration  |
+| Matplotlib               | Data visualization     |
+| Typer                    | Command-line interface |
+
+---
+
+## Installation
+
+Clone repository:
+
+```bash
+git clone https://github.com/your-repository/solvedesk-ai.git
+cd solvedesk-ai
+```
+
+Install dependencies:
+
+```bash
+pip install -r requirements.txt
+```
+
+Initialize project:
+
+```bash
+solvedesk conf init
+```
+
+Initialize vector database:
+
+```bash
+solvedesk db init
+```
+
+Configure local LLM:
+
+```bash
+solvedesk llm init
+```
+
+---
+
+## CLI Commands
+
+### Project Configuration
+
+```bash
+solvedesk conf init
+```
+
+Initialize project environment.
+
+### Database
+
+```bash
+solvedesk db init
+```
+
+Create vector database and download embedding model.
+
+```bash
+solvedesk db list
+```
+
+Display available collections.
+
+```bash
+solvedesk db details COLLECTION_NAME
+```
+
+Display collection details.
+
+### Data Synchronization
+
+```bash
+solvedesk sync api
+```
+
+Import documents from external API.
+
+```bash
+solvedesk sync file
+```
+
+Import documents from CSV, JSON or XLSX files.
+
+### Data Analysis
+
+```bash
+solvedesk data revision
+```
+
+Generate reports containing:
+
+* cosine similarity statistics
+* cluster distribution
+* token statistics
+* PCA visualization
+
+### Chunking
+
+```bash
+solvedesk data chunk
+```
+
+Split large documents into smaller chunks suitable for RAG systems.
+
+### LLM Configuration
+
+```bash
+solvedesk llm init
+```
+
+Configure Ollama host and model.
+
+### Run Application
+
+```bash
+solvedesk run:app
+```
+
+Start FastAPI server.
+
+---
+
+## Supported Data Structures
+
+### FAQ
+
+```json
+{
+  "question": "How to reset password?",
+  "answer": "Use reset password page."
+}
+```
+
+### Knowledge Base
+
+```json
+{
+  "name": "VPN Connection",
+  "question": "Cannot connect to VPN",
+  "answer": "Verify credentials and VPN client configuration."
+}
+```
+
+---
+
+## Example Workflow
+
+```bash
+solvedesk conf init
+solvedesk db init
+solvedesk sync file
+solvedesk data revision
+solvedesk llm init
+solvedesk run:app
+```
+
+---
+
+## Project Goals
+
+* Build local intelligent knowledge bases
+* Simplify RAG implementation
+* Support AI experimentation
+* Provide full control over data
+* Enable local LLM deployments
+* Offer educational value for learning AI technologies
+
+---
+
+## License
+
+MIT License

solvedesk_ai-0.1.0/solvedesk_ai.egg-info/SOURCES.txt

@@ -0,0 +1,11 @@
+README.md
+pyproject.toml
+setup.py
+solvedesk_ai.egg-info/PKG-INFO
+solvedesk_ai.egg-info/SOURCES.txt
+solvedesk_ai.egg-info/dependency_links.txt
+solvedesk_ai.egg-info/entry_points.txt
+solvedesk_ai.egg-info/requires.txt
+solvedesk_ai.egg-info/top_level.txt
+solvedesk_cmd/__init__.py
+solvedesk_cmd/cmd.py

solvedesk_ai-0.1.0/solvedesk_ai.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

solvedesk_ai-0.1.0/solvedesk_ai.egg-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+solvedesk = solvedesk.cli:app

solvedesk_ai-0.1.0/solvedesk_ai.egg-info/requires.txt

@@ -0,0 +1,5 @@
+typer
+fastapi
+chromadb
+sentence-transformers
+python-dotenv

solvedesk_ai-0.1.0/solvedesk_ai.egg-info/top_level.txt

@@ -0,0 +1 @@
+solvedesk_cmd

solvedesk_ai-0.1.0/solvedesk_cmd/cmd.py

@@ -0,0 +1,22 @@
+import typer
+
+from solvedesk_cmd.commands.conf import app as conf_cmd
+from solvedesk_cmd.commands.db import app as db_cmd
+from solvedesk_cmd.commands.sync import app as sync_cmd
+from solvedesk_cmd.commands.llm import app as llm_cmd
+from solvedesk_cmd.commands.data import app as data_cmd
+from solvedesk_cmd.commands.security import app as secure_cmd
+from solvedesk_cmd.commands.main import app as main_cmd
+
+app = typer.Typer(name="solvedesk")
+
+app.add_typer(conf_cmd, name="conf", help="SolveDesk configuration")
+app.add_typer(db_cmd, name="db", help="Vector Database configuration")
+app.add_typer(sync_cmd, name="sync", help="Data Loader Configuration")
+app.add_typer(llm_cmd, name="llm", help="LLM Configuration")
+app.add_typer(data_cmd, name="data", help="Data & Embeddings analyse")
+app.add_typer(secure_cmd, name="security", help="Configure Security by JWT")
+app.add_typer(main_cmd, name="main", help="SolveDesk API Launcher")
+
+if __name__ == "__main__":
+    app()