iatoolkit 0.63.6__tar.gz

iatoolkit-0.63.6/PKG-INFO

@@ -0,0 +1,258 @@
+Metadata-Version: 2.4
+Name: iatoolkit
+Version: 0.63.6
+Summary: IAToolkit
+Author: Fernando Libedinsky
+License-Expression: MIT
+Requires-Python: >=3.12
+Description-Content-Type: text/markdown
+Requires-Dist: aiohappyeyeballs==2.4.4
+Requires-Dist: aiohttp==3.11.9
+Requires-Dist: aiosignal==1.3.1
+Requires-Dist: annotated-types==0.7.0
+Requires-Dist: anyio==4.6.2.post1
+Requires-Dist: asgiref==3.8.1
+Requires-Dist: async-timeout==4.0.3
+Requires-Dist: attrs==24.3.0
+Requires-Dist: backoff==2.2.1
+Requires-Dist: bcrypt==4.2.1
+Requires-Dist: beautifulsoup4==4.12.3
+Requires-Dist: blinker==1.9.0
+Requires-Dist: boto3==1.36.22
+Requires-Dist: botocore==1.36.22
+Requires-Dist: build==1.2.2.post1
+Requires-Dist: cachelib==0.13.0
+Requires-Dist: cachetools==5.5.0
+Requires-Dist: certifi==2024.12.14
+Requires-Dist: cffi==1.17.1
+Requires-Dist: charset-normalizer==3.4.0
+Requires-Dist: click==8.1.8
+Requires-Dist: coloredlogs==15.0.1
+Requires-Dist: contourpy==1.3.3
+Requires-Dist: coverage==7.6.10
+Requires-Dist: cryptography==44.0.3
+Requires-Dist: cycler==0.12.1
+Requires-Dist: dataclasses-json==0.6.7
+Requires-Dist: Deprecated==1.2.15
+Requires-Dist: distro==1.9.0
+Requires-Dist: durationpy==0.9
+Requires-Dist: ecs-logging==2.2.0
+Requires-Dist: elastic-apm==6.23.0
+Requires-Dist: et_xmlfile==2.0.0
+Requires-Dist: exceptiongroup==1.2.2
+Requires-Dist: fastapi==0.115.6
+Requires-Dist: filelock==3.16.1
+Requires-Dist: Flask==3.1.0
+Requires-Dist: Flask-Bcrypt==1.0.1
+Requires-Dist: flask-cors==6.0.0
+Requires-Dist: Flask-Injector==0.15.0
+Requires-Dist: Flask-Session==0.8.0
+Requires-Dist: flatbuffers==24.3.25
+Requires-Dist: fonttools==4.59.2
+Requires-Dist: frozenlist==1.5.0
+Requires-Dist: fsspec==2024.10.0
+Requires-Dist: google-ai-generativelanguage==0.6.15
+Requires-Dist: google-api-core==2.24.1
+Requires-Dist: google-api-python-client==2.161.0
+Requires-Dist: google-auth==2.37.0
+Requires-Dist: google-auth-httplib2==0.2.0
+Requires-Dist: google-auth-oauthlib==1.2.1
+Requires-Dist: google-cloud-core==2.4.1
+Requires-Dist: google-cloud-storage==3.0.0
+Requires-Dist: google-crc32c==1.6.0
+Requires-Dist: google-generativeai==0.8.5
+Requires-Dist: google-resumable-media==2.7.2
+Requires-Dist: googleapis-common-protos==1.66.0
+Requires-Dist: grpcio==1.74.0
+Requires-Dist: grpcio-status==1.71.2
+Requires-Dist: gunicorn==23.0.0
+Requires-Dist: h11==0.14.0
+Requires-Dist: httpcore==1.0.7
+Requires-Dist: httplib2==0.22.0
+Requires-Dist: httptools==0.6.4
+Requires-Dist: httpx==0.28.0
+Requires-Dist: httpx-sse==0.4.0
+Requires-Dist: huggingface-hub==0.31.4
+Requires-Dist: humanfriendly==10.0
+Requires-Dist: idna==3.10
+Requires-Dist: importlib_metadata==8.5.0
+Requires-Dist: importlib_resources==6.4.5
+Requires-Dist: iniconfig==2.0.0
+Requires-Dist: injector==0.22.0
+Requires-Dist: itsdangerous==2.2.0
+Requires-Dist: Jinja2==3.1.5
+Requires-Dist: jiter==0.8.0
+Requires-Dist: jmespath==1.0.1
+Requires-Dist: joblib==1.4.2
+Requires-Dist: jsonpatch==1.33
+Requires-Dist: jsonpointer==3.0.0
+Requires-Dist: kiwisolver==1.4.9
+Requires-Dist: kubernetes==31.0.0
+Requires-Dist: langchain==0.3.19
+Requires-Dist: langchain-core==0.3.35
+Requires-Dist: langchain-text-splitters==0.3.6
+Requires-Dist: langsmith==0.3.8
+Requires-Dist: lxml==5.3.0
+Requires-Dist: markdown-it-py==3.0.0
+Requires-Dist: markdown2==2.5.3
+Requires-Dist: MarkupSafe==3.0.2
+Requires-Dist: marshmallow==3.23.1
+Requires-Dist: matplotlib==3.10.6
+Requires-Dist: mdurl==0.1.2
+Requires-Dist: mmh3==5.0.1
+Requires-Dist: monotonic==1.6
+Requires-Dist: mpmath==1.3.0
+Requires-Dist: msgspec==0.19.0
+Requires-Dist: multidict==6.1.0
+Requires-Dist: mypy-extensions==1.0.0
+Requires-Dist: narwhals==2.3.0
+Requires-Dist: networkx==3.4.2
+Requires-Dist: numpy==2.2.3
+Requires-Dist: oauth2client==4.1.3
+Requires-Dist: oauthlib==3.2.2
+Requires-Dist: onnxruntime==1.19.2
+Requires-Dist: openai==1.79.0
+Requires-Dist: openpyxl==3.1.5
+Requires-Dist: opentelemetry-api==1.28.2
+Requires-Dist: opentelemetry-exporter-otlp-proto-common==1.28.2
+Requires-Dist: opentelemetry-exporter-otlp-proto-grpc==1.28.2
+Requires-Dist: opentelemetry-instrumentation==0.49b2
+Requires-Dist: opentelemetry-instrumentation-asgi==0.49b2
+Requires-Dist: opentelemetry-instrumentation-fastapi==0.49b2
+Requires-Dist: opentelemetry-proto==1.28.2
+Requires-Dist: opentelemetry-sdk==1.28.2
+Requires-Dist: opentelemetry-semantic-conventions==0.49b2
+Requires-Dist: opentelemetry-util-http==0.49b2
+Requires-Dist: orjson==3.10.12
+Requires-Dist: overrides==7.7.0
+Requires-Dist: packaging==24.2
+Requires-Dist: pandas==2.3.1
+Requires-Dist: pgvector==0.3.6
+Requires-Dist: pillow==11.0.0
+Requires-Dist: plotly==6.3.0
+Requires-Dist: pluggy==1.5.0
+Requires-Dist: posthog==3.7.4
+Requires-Dist: propcache==0.2.1
+Requires-Dist: proto-plus==1.26.0
+Requires-Dist: protobuf==5.29.1
+Requires-Dist: psutil==7.0.0
+Requires-Dist: psycopg2-binary==2.9.10
+Requires-Dist: pyarrow==21.0.0
+Requires-Dist: pyasn1==0.6.1
+Requires-Dist: pyasn1_modules==0.4.1
+Requires-Dist: pycparser==2.22
+Requires-Dist: pydantic==2.10.2
+Requires-Dist: pydantic-settings==2.6.1
+Requires-Dist: pydantic_core==2.27.1
+Requires-Dist: PyDrive==1.3.1
+Requires-Dist: Pygments==2.18.0
+Requires-Dist: PyJWT==2.10.1
+Requires-Dist: PyMuPDF==1.25.0
+Requires-Dist: pyparsing==3.2.1
+Requires-Dist: pypdf==5.1.0
+Requires-Dist: PyPika==0.48.9
+Requires-Dist: pyproject_hooks==1.2.0
+Requires-Dist: pytesseract==0.3.13
+Requires-Dist: pytest==8.3.4
+Requires-Dist: pytest-cov==5.0.0
+Requires-Dist: pytest-mock==3.14.0
+Requires-Dist: python-dateutil==2.9.0.post0
+Requires-Dist: python-docx==1.1.2
+Requires-Dist: python-dotenv==1.0.1
+Requires-Dist: pytz==2025.2
+Requires-Dist: PyYAML==6.0.2
+Requires-Dist: redis==5.2.1
+Requires-Dist: regex==2024.11.6
+Requires-Dist: requests==2.32.3
+Requires-Dist: requests-oauthlib==2.0.0
+Requires-Dist: requests-toolbelt==1.0.0
+Requires-Dist: rich==13.9.4
+Requires-Dist: rsa==4.9
+Requires-Dist: s3transfer==0.11.2
+Requires-Dist: safetensors==0.5.2
+Requires-Dist: scikit-learn==1.7.1
+Requires-Dist: scipy==1.15.1
+Requires-Dist: seaborn==0.13.2
+Requires-Dist: setuptools==75.8.0
+Requires-Dist: shellingham==1.5.4
+Requires-Dist: sib-api-v3-sdk==7.6.0
+Requires-Dist: six==1.17.0
+Requires-Dist: sniffio==1.3.1
+Requires-Dist: soupsieve==2.6
+Requires-Dist: SQLAlchemy==2.0.36
+Requires-Dist: starlette==0.41.3
+Requires-Dist: sympy==1.13.1
+Requires-Dist: tenacity==9.0.0
+Requires-Dist: threadpoolctl==3.5.0
+Requires-Dist: tiktoken==0.8.0
+Requires-Dist: tokenizers==0.21.0
+Requires-Dist: tomli==2.2.1
+Requires-Dist: tqdm==4.67.1
+Requires-Dist: typer==0.15.1
+Requires-Dist: typing-inspect==0.9.0
+Requires-Dist: typing_extensions==4.12.2
+Requires-Dist: tzdata==2025.2
+Requires-Dist: uritemplate==4.1.1
+Requires-Dist: urllib3==2.3.0
+Requires-Dist: uvicorn==0.32.1
+Requires-Dist: uvloop==0.21.0
+Requires-Dist: watchfiles==1.0.0
+Requires-Dist: websocket-client==1.8.0
+Requires-Dist: websockets==14.1
+Requires-Dist: Werkzeug==3.1.3
+Requires-Dist: whitenoise==6.8.2
+Requires-Dist: wikipedia==1.4.0
+Requires-Dist: wrapt==1.17.0
+Requires-Dist: yarl==1.18.3
+Requires-Dist: zipp==3.21.0
+Requires-Dist: zstandard==0.23.0
+
+
+<div align="center">
+  <h1>IAToolkit</h1>
+  <p><strong>The Open-Source Framework for Building AI Chatbots on Your Private Data.</strong></p>
+</div>
+
+IAToolkit is a comprehensive, open-source framework designed for building enterprise-grade 
+AI chatbots and conversational applications. 
+With IAToolkit, you can build production-ready, context-aware chatbots and agents that 
+can query relational databases, perform semantic searches on documents, 
+and connect to your internal APIs in minutes.
+
+IAToolkit bridges the gap between powerful LLMs and your company's data. 
+
+
+## 🚀 Key Features
+
+*   **🔗 Unified Data Connection**:
+    *   **Natural Language to SQL**: Let your chatbot query relational databases (PostgreSQL, MySQL, SQLite) using everyday language.
+    *   **Semantic Document Search**: Automatically chunk, embed, and search across your private documents (PDFs, Word, etc.) to provide contextually accurate answers.
+
+*   **🏢 Enterprise-Ready Multi-Tenancy**:
+    *   Deploy isolated "Company" modules, each with its own data, tools, and context. Perfect for SaaS products or internal departmental agents.
+
+*   **🧠 LLM Agnostic**:
+    *   Switch between **OpenAI (GPT-*)** and **Google (Gemini-*)** with a single line change in your configuration. No code refactoring needed.
+
+*   **🛠️ Developer-First Experience**:
+    *   Built with a clean, **Dependency Injection** architecture.
+    *   High-quality code base with **90%+ test coverage**.
+    *   Powerful Flask-based **CLI** for database setup, API key generation, and more.
+
+*   **🔒 Security & Observability Built-In**:
+    *   Comes with JWT-based authentication, user management, and secure session handling out of the box.
+    *   Full traceability with detailed logging of all queries, function calls, token usage, and costs.
+
+## ⚡ Quick Start: Create a Custom Tool in 30 Seconds
+
+See how easy it is to give your AI a new skill. Just define a method inside your Company class and describe it. 
+IAToolkit handles the rest.
+
+## 🤝 Contributing
+
+We welcome contributions! Whether it's adding a new feature, improving documentation, or fixing a bug, 
+please feel free to open a pull request.
+
+## 📄 License
+
+IAToolkit is open-source and licensed under the [MIT License](LICENSE).

iatoolkit-0.63.6/pyproject.toml

@@ -0,0 +1,29 @@
+[build-system]
+requires = ["setuptools>=68", "wheel", "build"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "iatoolkit"
+version = "0.63.6"
+requires-python = ">=3.12"
+description = "IAToolkit"
+readme = "readme.md"
+license = "MIT"
+authors = [{ name = "Fernando Libedinsky" }]
+
+# Si quieres seguir leyendo deps de requirements.txt:
+dynamic = ["dependencies"]
+
+[tool.setuptools]
+package-dir = {"" = "src"}
+
+[tool.setuptools.packages.find]
+where = ["src"]
+exclude = ["tests*", "*/tests*"]
+
+
+[tool.setuptools.dynamic]
+dependencies = { file = ["requirements.txt"] }
+
+[tool.setuptools.package-data]
+iatoolkit = ["system_prompts/*.prompt", "templates/**/*", "static/**/*"]

iatoolkit-0.63.6/readme.md

@@ -0,0 +1,49 @@
+
+<div align="center">
+  <h1>IAToolkit</h1>
+  <p><strong>The Open-Source Framework for Building AI Chatbots on Your Private Data.</strong></p>
+</div>
+
+IAToolkit is a comprehensive, open-source framework designed for building enterprise-grade 
+AI chatbots and conversational applications. 
+With IAToolkit, you can build production-ready, context-aware chatbots and agents that 
+can query relational databases, perform semantic searches on documents, 
+and connect to your internal APIs in minutes.
+
+IAToolkit bridges the gap between powerful LLMs and your company's data. 
+
+
+## 🚀 Key Features
+
+*   **🔗 Unified Data Connection**:
+    *   **Natural Language to SQL**: Let your chatbot query relational databases (PostgreSQL, MySQL, SQLite) using everyday language.
+    *   **Semantic Document Search**: Automatically chunk, embed, and search across your private documents (PDFs, Word, etc.) to provide contextually accurate answers.
+
+*   **🏢 Enterprise-Ready Multi-Tenancy**:
+    *   Deploy isolated "Company" modules, each with its own data, tools, and context. Perfect for SaaS products or internal departmental agents.
+
+*   **🧠 LLM Agnostic**:
+    *   Switch between **OpenAI (GPT-*)** and **Google (Gemini-*)** with a single line change in your configuration. No code refactoring needed.
+
+*   **🛠️ Developer-First Experience**:
+    *   Built with a clean, **Dependency Injection** architecture.
+    *   High-quality code base with **90%+ test coverage**.
+    *   Powerful Flask-based **CLI** for database setup, API key generation, and more.
+
+*   **🔒 Security & Observability Built-In**:
+    *   Comes with JWT-based authentication, user management, and secure session handling out of the box.
+    *   Full traceability with detailed logging of all queries, function calls, token usage, and costs.
+
+## ⚡ Quick Start: Create a Custom Tool in 30 Seconds
+
+See how easy it is to give your AI a new skill. Just define a method inside your Company class and describe it. 
+IAToolkit handles the rest.
+
+## 🤝 Contributing
+
+We welcome contributions! Whether it's adding a new feature, improving documentation, or fixing a bug, 
+please feel free to open a pull request.
+
+## 📄 License
+
+IAToolkit is open-source and licensed under the [MIT License](LICENSE).

iatoolkit-0.63.6/requirements.txt

@@ -0,0 +1,200 @@
+aiohappyeyeballs==2.4.4
+aiohttp==3.11.9
+aiosignal==1.3.1
+annotated-types==0.7.0
+anyio==4.6.2.post1
+asgiref==3.8.1
+async-timeout==4.0.3
+attrs==24.3.0
+backoff==2.2.1
+bcrypt==4.2.1
+beautifulsoup4==4.12.3
+blinker==1.9.0
+boto3==1.36.22
+botocore==1.36.22
+build==1.2.2.post1
+cachelib==0.13.0
+cachetools==5.5.0
+certifi==2024.12.14
+cffi==1.17.1
+charset-normalizer==3.4.0
+click==8.1.8
+coloredlogs==15.0.1
+contourpy==1.3.3
+coverage==7.6.10
+cryptography==44.0.3
+cycler==0.12.1
+dataclasses-json==0.6.7
+Deprecated==1.2.15
+distro==1.9.0
+durationpy==0.9
+ecs-logging==2.2.0
+elastic-apm==6.23.0
+et_xmlfile==2.0.0
+exceptiongroup==1.2.2
+fastapi==0.115.6
+filelock==3.16.1
+Flask==3.1.0
+Flask-Bcrypt==1.0.1
+flask-cors==6.0.0
+Flask-Injector==0.15.0
+Flask-Session==0.8.0
+flatbuffers==24.3.25
+fonttools==4.59.2
+frozenlist==1.5.0
+fsspec==2024.10.0
+google-ai-generativelanguage==0.6.15
+google-api-core==2.24.1
+google-api-python-client==2.161.0
+google-auth==2.37.0
+google-auth-httplib2==0.2.0
+google-auth-oauthlib==1.2.1
+google-cloud-core==2.4.1
+google-cloud-storage==3.0.0
+google-crc32c==1.6.0
+google-generativeai==0.8.5
+google-resumable-media==2.7.2
+googleapis-common-protos==1.66.0
+grpcio==1.74.0
+grpcio-status==1.71.2
+gunicorn==23.0.0
+h11==0.14.0
+httpcore==1.0.7
+httplib2==0.22.0
+httptools==0.6.4
+httpx==0.28.0
+httpx-sse==0.4.0
+huggingface-hub==0.31.4
+humanfriendly==10.0
+idna==3.10
+importlib_metadata==8.5.0
+importlib_resources==6.4.5
+iniconfig==2.0.0
+injector==0.22.0
+itsdangerous==2.2.0
+Jinja2==3.1.5
+jiter==0.8.0
+jmespath==1.0.1
+joblib==1.4.2
+jsonpatch==1.33
+jsonpointer==3.0.0
+kiwisolver==1.4.9
+kubernetes==31.0.0
+langchain==0.3.19
+langchain-core==0.3.35
+langchain-text-splitters==0.3.6
+langsmith==0.3.8
+lxml==5.3.0
+markdown-it-py==3.0.0
+markdown2==2.5.3
+MarkupSafe==3.0.2
+marshmallow==3.23.1
+matplotlib==3.10.6
+mdurl==0.1.2
+mmh3==5.0.1
+monotonic==1.6
+mpmath==1.3.0
+msgspec==0.19.0
+multidict==6.1.0
+mypy-extensions==1.0.0
+narwhals==2.3.0
+networkx==3.4.2
+numpy==2.2.3
+oauth2client==4.1.3
+oauthlib==3.2.2
+onnxruntime==1.19.2
+openai==1.79.0
+openpyxl==3.1.5
+opentelemetry-api==1.28.2
+opentelemetry-exporter-otlp-proto-common==1.28.2
+opentelemetry-exporter-otlp-proto-grpc==1.28.2
+opentelemetry-instrumentation==0.49b2
+opentelemetry-instrumentation-asgi==0.49b2
+opentelemetry-instrumentation-fastapi==0.49b2
+opentelemetry-proto==1.28.2
+opentelemetry-sdk==1.28.2
+opentelemetry-semantic-conventions==0.49b2
+opentelemetry-util-http==0.49b2
+orjson==3.10.12
+overrides==7.7.0
+packaging==24.2
+pandas==2.3.1
+pgvector==0.3.6
+pillow==11.0.0
+plotly==6.3.0
+pluggy==1.5.0
+posthog==3.7.4
+propcache==0.2.1
+proto-plus==1.26.0
+protobuf==5.29.1
+psutil==7.0.0
+psycopg2-binary==2.9.10
+pyarrow==21.0.0
+pyasn1==0.6.1
+pyasn1_modules==0.4.1
+pycparser==2.22
+pydantic==2.10.2
+pydantic-settings==2.6.1
+pydantic_core==2.27.1
+PyDrive==1.3.1
+Pygments==2.18.0
+PyJWT==2.10.1
+PyMuPDF==1.25.0
+pyparsing==3.2.1
+pypdf==5.1.0
+PyPika==0.48.9
+pyproject_hooks==1.2.0
+pytesseract==0.3.13
+pytest==8.3.4
+pytest-cov==5.0.0
+pytest-mock==3.14.0
+python-dateutil==2.9.0.post0
+python-docx==1.1.2
+python-dotenv==1.0.1
+pytz==2025.2
+PyYAML==6.0.2
+redis==5.2.1
+regex==2024.11.6
+requests==2.32.3
+requests-oauthlib==2.0.0
+requests-toolbelt==1.0.0
+rich==13.9.4
+rsa==4.9
+s3transfer==0.11.2
+safetensors==0.5.2
+scikit-learn==1.7.1
+scipy==1.15.1
+seaborn==0.13.2
+setuptools==75.8.0
+shellingham==1.5.4
+sib-api-v3-sdk==7.6.0
+six==1.17.0
+sniffio==1.3.1
+soupsieve==2.6
+SQLAlchemy==2.0.36
+starlette==0.41.3
+sympy==1.13.1
+tenacity==9.0.0
+threadpoolctl==3.5.0
+tiktoken==0.8.0
+tokenizers==0.21.0
+tomli==2.2.1
+tqdm==4.67.1
+typer==0.15.1
+typing-inspect==0.9.0
+typing_extensions==4.12.2
+tzdata==2025.2
+uritemplate==4.1.1
+urllib3==2.3.0
+uvicorn==0.32.1
+uvloop==0.21.0
+watchfiles==1.0.0
+websocket-client==1.8.0
+websockets==14.1
+Werkzeug==3.1.3
+whitenoise==6.8.2
+wikipedia==1.4.0
+wrapt==1.17.0
+yarl==1.18.3
+zipp==3.21.0
+zstandard==0.23.0

iatoolkit-0.63.6/setup.cfg

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

iatoolkit-0.63.6/src/iatoolkit/__init__.py

@@ -0,0 +1,38 @@
+"""
+IAToolkit Package
+"""
+
+# Expose main classes and functions at the top level of the package
+
+# main IAToolkit class
+from .iatoolkit import IAToolkit, current_iatoolkit, create_app
+
+# for registering the client companies
+from .company_registry import register_company
+from .base_company import BaseCompany
+from iatoolkit.repositories.database_manager import DatabaseManager
+
+# --- Services ---
+from iatoolkit.services.query_service import QueryService
+from iatoolkit.services.sql_service import SqlService
+from iatoolkit.services.document_service import DocumentService
+from iatoolkit.services.search_service import SearchService
+from iatoolkit.services.load_documents_service import LoadDocumentsService
+from iatoolkit.services.excel_service import ExcelService
+from iatoolkit.infra.call_service import CallServiceClient
+
+__all__ = [
+    'IAToolkit',
+    'create_app',
+    'current_iatoolkit',
+    'register_company',
+    'BaseCompany',
+    'DatabaseManager',
+    'QueryService',
+    'SqlService',
+    'ExcelService',
+    'DocumentService',
+    'SearchService',
+    'LoadDocumentsService',
+    'CallServiceClient',
+]

iatoolkit-0.63.6/src/iatoolkit/base_company.py

@@ -0,0 +1,119 @@
+# Copyright (c) 2024 Fernando Libedinsky
+# Product: IAToolkit
+#
+# IAToolkit is open source software.
+
+# companies/base_company.py
+from abc import ABC, abstractmethod
+from iatoolkit.repositories.profile_repo import ProfileRepo
+from iatoolkit.repositories.llm_query_repo import LLMQueryRepo
+
+from iatoolkit.services.prompt_manager_service import PromptService
+from iatoolkit.repositories.models import Company, Function, PromptCategory
+from iatoolkit import IAToolkit
+
+
+class BaseCompany(ABC):
+    def __init__(self):
+        # Obtener el inyector global y resolver las dependencias internamente
+        injector = IAToolkit.get_instance().get_injector()
+        self.profile_repo: ProfileRepo = injector.get(ProfileRepo)
+        self.llm_query_repo: LLMQueryRepo = injector.get(LLMQueryRepo)
+        self.prompt_service: PromptService = injector.get(PromptService)
+        self.company: Company | None = None
+
+    def _load_company_by_short_name(self, short_name: str) -> Company:
+        self.company = self.profile_repo.get_company_by_short_name(short_name)
+        return self.company
+
+    def _create_company(self,
+                        short_name: str,
+                        name: str,
+                        parameters: dict | None = None,
+                        branding: dict | None = None,
+                        onboarding_cards: dict | None = None,
+                        ) -> Company:
+        company_obj = Company(short_name=short_name,
+                              name=name,
+                              parameters=parameters,
+                              branding=branding,
+                              onboarding_cards=onboarding_cards)
+        self.company = self.profile_repo.create_company(company_obj)
+        return self.company
+
+    def _create_function(self, function_name: str, description: str, params: dict, **kwargs):
+        if not self.company:
+            raise ValueError("La compañía debe estar definida antes de crear una función.")
+
+        self.llm_query_repo.create_or_update_function(
+            Function(
+                company_id=self.company.id,
+                name=function_name,
+                description=description,
+                parameters=params,
+                system_function=False,
+                **kwargs
+            )
+        )
+
+    def _create_prompt_category(self, name: str, order: int) -> PromptCategory:
+        if not self.company:
+            raise ValueError("La compañía debe estar definida antes de crear una categoría.")
+
+        return self.llm_query_repo.create_or_update_prompt_category(
+            PromptCategory(name=name, order=order, company_id=self.company.id)
+        )
+
+    def _create_prompt(self, prompt_name: str, description: str, category: PromptCategory, order: int, **kwargs):
+        if not self.company:
+            raise ValueError("La compañía debe estar definida antes de crear un prompt.")
+
+        self.prompt_service.create_prompt(
+            prompt_name=prompt_name,
+            description=description,
+            order=order,
+            company=self.company,
+            category=category,
+            **kwargs
+        )
+
+
+    @abstractmethod
+    # initialize all the database tables  needed
+    def register_company(self):
+        raise NotImplementedError("La subclase debe implementar el método create_company()")
+
+    @abstractmethod
+    # get context specific for this company
+    def get_company_context(self, **kwargs) -> str:
+        raise NotImplementedError("La subclase debe implementar el método get_company_context()")
+
+    @abstractmethod
+    # get context specific for this company
+    def get_user_info(self, user_identifier: str) -> dict:
+        raise NotImplementedError("La subclase debe implementar el método get_user_info()")
+
+    @abstractmethod
+    # execute the specific action configured in the intent table
+    def handle_request(self, tag: str, params: dict) -> dict:
+        raise NotImplementedError("La subclase debe implementar el método handle_request()")
+
+    @abstractmethod
+    # get context specific for the query
+    def start_execution(self):
+        raise NotImplementedError("La subclase debe implementar el método start_execution()")
+
+    @abstractmethod
+    # get context specific for the query
+    def get_metadata_from_filename(self, filename: str) -> dict:
+        raise NotImplementedError("La subclase debe implementar el método get_query_context()")
+
+    def register_cli_commands(self, app):
+        """
+        optional method for a company definition of it's cli commands
+        """
+        pass
+
+
+    def unsupported_operation(self, tag):
+        raise NotImplementedError(f"La operación '{tag}' no está soportada por esta empresa.")