pinetext 0.1.7__tar.gz

pinetext-0.1.7/.devcontainer/Dockerfile

@@ -0,0 +1,5 @@
+FROM ghcr.io/astral-sh/uv:python3.13-bookworm-slim
+
+RUN apt-get update && \
+    apt-get install -y --no-install-recommends git && \
+    rm -rf /var/lib/apt/lists/*

pinetext-0.1.7/.devcontainer/devcontainer.json

@@ -0,0 +1,14 @@
+{
+  "build": {
+    "dockerfile": "Dockerfile"
+  },
+  "customizations": {
+    "vscode": {
+      "extensions": [
+        "ms-python.python",
+        "ms-python.vscode-pylance"
+      ]
+    }
+  },
+  "postCreateCommand": "bash .devcontainer/post-create.sh"
+}

pinetext-0.1.7/.devcontainer/post-create.sh

@@ -0,0 +1,4 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+uv sync

pinetext-0.1.7/.dockerignore

@@ -0,0 +1,7 @@
+*
+!Dockerfile
+!pyproject.toml
+!README.md
+!uv.lock
+!src/
+!src/**

pinetext-0.1.7/.env.example

@@ -0,0 +1,6 @@
+pinetext_pinecone__api_key=your-api-key
+pinetext_pinecone__assistant=assistant-name
+pinetext_pinecone__data_dir=data
+pinetext_pinecone__model=o4-mini
+pinetext_wandb__api_key=wandb-api-key
+pinetext_wandb__project=pinetext

pinetext-0.1.7/.github/dependabot.yml

@@ -0,0 +1,14 @@
+version: 2
+multi-ecosystem-groups:
+  all:
+    schedule:
+      interval: "weekly"
+updates:
+  - package-ecosystem: "uv"
+    directory: "/"
+    patterns: ["*"]
+    multi-ecosystem-group: "all"
+  - package-ecosystem: "github-actions"
+    directory: "/"
+    patterns: ["*"]
+    multi-ecosystem-group: "all"

pinetext-0.1.7/.github/workflows/codeql.yml

@@ -0,0 +1,39 @@
+# codeql.yml
+
+name: codeql
+
+on:
+  pull_request:
+    branches: [main]
+    types: [opened, synchronize]
+  schedule:
+    - cron: '11 5 * * 3'
+
+jobs:
+  analyze:
+    name: Analyze (${{ matrix.language }})
+    runs-on: ubuntu-latest
+    permissions:
+      actions: read
+      contents: read
+      packages: read
+      security-events: write
+
+    strategy:
+      fail-fast: false
+      matrix:
+        include:
+        - language: actions
+          build-mode: none
+        - language: python
+          build-mode: none
+
+    steps:
+    - uses: actions/checkout@v6
+    - uses: github/codeql-action/init@v4
+      with:
+        languages: ${{ matrix.language }}
+        build-mode: ${{ matrix.build-mode }}
+    - uses: github/codeql-action/analyze@v4
+      with:
+        category: "/language:${{matrix.language}}"

pinetext-0.1.7/.github/workflows/prod.yml

@@ -0,0 +1,38 @@
+# prod.yml
+
+name: prod
+
+on:
+  release:
+    types: [created]
+
+jobs:
+  publish:
+    permissions:
+      contents: read
+      packages: write
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@v6
+      - uses: docker/login-action@v3
+        with:
+          registry: ghcr.io
+          username: ${{ github.actor }}
+          password: ${{ secrets.GITHUB_TOKEN }}
+      - name: Metadata
+        id: meta
+        uses: docker/metadata-action@v5
+        with:
+          images: ghcr.io/ezhuk/pinetext
+          tags: |
+            type=semver,pattern={{version}}
+            type=semver,pattern=latest
+      - uses: docker/setup-buildx-action@v3
+      - uses: docker/build-push-action@v6
+        with:
+          cache-from: type=gha
+          cache-to: type=gha,mode=max
+          context: .
+          push: true
+          tags: ${{ steps.meta.outputs.tags }}

pinetext-0.1.7/.github/workflows/pypi.yml

@@ -0,0 +1,30 @@
+# pypi.yml
+
+name: pypi
+
+on:
+  release:
+    types: [published]
+  workflow_dispatch:
+
+jobs:
+  publish:
+    environment:
+      name: pypi
+      url: https://pypi.org/p/pinetext
+    permissions:
+      contents: read
+      id-token: write
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@v6
+      - uses: astral-sh/setup-uv@v7
+      - uses: actions/setup-python@v6
+        with:
+          python-version-file: .python-version
+      - run: |
+          uv build
+      - uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          packages-dir: dist/

pinetext-0.1.7/.github/workflows/test.yml

@@ -0,0 +1,31 @@
+# test.yml
+
+name: test
+
+on:
+  pull_request:
+    branches: [main]
+    types: [opened, synchronize]
+  push:
+    branches: [main]
+
+jobs:
+  build:
+    permissions:
+      contents: read
+      id-token: write
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@v6
+      - uses: astral-sh/setup-uv@v7
+      - uses: actions/setup-python@v6
+        with:
+          python-version-file: .python-version
+      - run: |
+          uv sync
+          uv run pre-commit run --all-files
+          uv run pytest --cov=pinetext --cov-report=xml
+      - uses: codecov/codecov-action@v5
+        with:
+          use_oidc: true

pinetext-0.1.7/.gitignore

@@ -0,0 +1,3 @@
+.venv/
+__pycache__/
+dist/

pinetext-0.1.7/.pre-commit-config.yaml

@@ -0,0 +1,11 @@
+repos:
+- repo: https://github.com/astral-sh/ruff-pre-commit
+  rev: v0.12.10
+  hooks:
+    - id: ruff-check
+    - id: ruff-format
+- repo: https://github.com/pre-commit/mirrors-mypy
+  rev: v1.17.0
+  hooks:
+    - id: mypy
+      files: src

pinetext-0.1.7/.python-version

@@ -0,0 +1 @@
+3.13

pinetext-0.1.7/Dockerfile

@@ -0,0 +1,20 @@
+FROM ghcr.io/astral-sh/uv:python3.13-bookworm-slim
+
+WORKDIR /app
+
+ENV UV_COMPILE_BYTECODE=1 \
+    UV_LINK_MODE=copy
+
+COPY pyproject.toml README.md uv.lock ./
+
+RUN --mount=type=cache,target=/root/.cache/uv \
+    uv sync --locked --no-install-project --no-dev
+
+COPY src /app/src
+
+RUN --mount=type=cache,target=/root/.cache/uv \
+    uv sync --locked --no-dev
+
+ENV PATH="/app/.venv/bin:$PATH"
+
+ENTRYPOINT ["pinetext"]

pinetext-0.1.7/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Eugene Zhuk
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

pinetext-0.1.7/PKG-INFO

@@ -0,0 +1,94 @@
+Metadata-Version: 2.4
+Name: pinetext
+Version: 0.1.7
+Summary: PineText
+License-File: LICENSE
+Requires-Python: >=3.13
+Requires-Dist: pinecone-plugin-assistant>=3.0.0
+Requires-Dist: pinecone>=8.0.0
+Requires-Dist: pydantic-settings>=2.12.0
+Requires-Dist: typer>=0.21.0
+Requires-Dist: wandb>=0.23.1
+Requires-Dist: weave>=0.52.23
+Description-Content-Type: text/markdown
+
+## PineText
+
+[![test](https://github.com/ezhuk/pinetext/actions/workflows/test.yml/badge.svg)](https://github.com/ezhuk/pinetext/actions/workflows/test.yml)
+[![codecov](https://codecov.io/github/ezhuk/pinetext/graph/badge.svg?token=0YJASFE5OM)](https://codecov.io/github/ezhuk/pinetext)
+[![PyPI - Version](https://img.shields.io/pypi/v/pinetext.svg)](https://pypi.org/p/pinetext)
+
+A lightweight assistant built using [Pinecone](https://docs.pinecone.io/guides/assistant/overview) that helps create RAG-based chat applications for reasoning over documents, retrieving relevant context, and providing grounded answers.
+
+## Getting Started
+
+Use [uv](https://github.com/astral-sh/uv) to add and manage PineText as a dependency in your project, or install it directly via `uv pip install` or `pip install`. See the [Installation](https://github.com/ezhuk/pinetext/blob/main/docs/pinetext/installation.mdx) section of the documentation for full installation instructions and more details.
+
+```bash
+uv add pinetext
+```
+
+It can be embedded in and run directly from your application.
+
+```python
+# app.py
+from pinetext import PineText
+
+def main():
+    pt = PineText()
+    pt.run()
+```
+
+It can also be launched from the command line using the provided `CLI` without modifying the source code.
+
+```
+pinetext
+```
+
+Or in an ephemeral, isolated environment using `uvx`. Check out the [Using tools](https://docs.astral.sh/uv/guides/tools/) guide for more details.
+
+```bash
+uvx pinetext
+```
+
+## Configuration
+
+Place documents in the `data` folder and make sure to set `PINECONE_API_KEY` and the assistant name before starting PineText.
+
+```bash
+export PINETEXT_PINECONE__API_KEY=your-api-key
+export PINETEXT_PINECONE__ASSISTANT=assistant-name
+export PINETEXT_PINECONE__DATA_DIR=data
+export PINETEXT_PINECONE__MODEL=o4-mini
+```
+
+These settings can also be specified in a `.env` file in the working directory.
+
+```text
+pinetext_pinecone__api_key=your-api-key
+pinetext_pinecone__assistant=assistant-name
+pinetext_pinecone__data_dir=data
+pinetext_pinecone__model=o4-mini
+```
+
+## Docker
+
+The PineText CLI can be deployed as a Docker container as follows:
+
+```bash
+docker run -it \
+  --name pinetext \
+  --env-file .env \
+  -v $(pwd)/data:/app/data
+  ghcr.io/ezhuk/pinetext:latest
+```
+
+Or using Docker Compose:
+
+```bash
+docker compose up
+```
+
+## License
+
+The server is licensed under the [MIT License](https://github.com/ezhuk/pinetext?tab=MIT-1-ov-file).

pinetext-0.1.7/README.md

@@ -0,0 +1,80 @@
+## PineText
+
+[![test](https://github.com/ezhuk/pinetext/actions/workflows/test.yml/badge.svg)](https://github.com/ezhuk/pinetext/actions/workflows/test.yml)
+[![codecov](https://codecov.io/github/ezhuk/pinetext/graph/badge.svg?token=0YJASFE5OM)](https://codecov.io/github/ezhuk/pinetext)
+[![PyPI - Version](https://img.shields.io/pypi/v/pinetext.svg)](https://pypi.org/p/pinetext)
+
+A lightweight assistant built using [Pinecone](https://docs.pinecone.io/guides/assistant/overview) that helps create RAG-based chat applications for reasoning over documents, retrieving relevant context, and providing grounded answers.
+
+## Getting Started
+
+Use [uv](https://github.com/astral-sh/uv) to add and manage PineText as a dependency in your project, or install it directly via `uv pip install` or `pip install`. See the [Installation](https://github.com/ezhuk/pinetext/blob/main/docs/pinetext/installation.mdx) section of the documentation for full installation instructions and more details.
+
+```bash
+uv add pinetext
+```
+
+It can be embedded in and run directly from your application.
+
+```python
+# app.py
+from pinetext import PineText
+
+def main():
+    pt = PineText()
+    pt.run()
+```
+
+It can also be launched from the command line using the provided `CLI` without modifying the source code.
+
+```
+pinetext
+```
+
+Or in an ephemeral, isolated environment using `uvx`. Check out the [Using tools](https://docs.astral.sh/uv/guides/tools/) guide for more details.
+
+```bash
+uvx pinetext
+```
+
+## Configuration
+
+Place documents in the `data` folder and make sure to set `PINECONE_API_KEY` and the assistant name before starting PineText.
+
+```bash
+export PINETEXT_PINECONE__API_KEY=your-api-key
+export PINETEXT_PINECONE__ASSISTANT=assistant-name
+export PINETEXT_PINECONE__DATA_DIR=data
+export PINETEXT_PINECONE__MODEL=o4-mini
+```
+
+These settings can also be specified in a `.env` file in the working directory.
+
+```text
+pinetext_pinecone__api_key=your-api-key
+pinetext_pinecone__assistant=assistant-name
+pinetext_pinecone__data_dir=data
+pinetext_pinecone__model=o4-mini
+```
+
+## Docker
+
+The PineText CLI can be deployed as a Docker container as follows:
+
+```bash
+docker run -it \
+  --name pinetext \
+  --env-file .env \
+  -v $(pwd)/data:/app/data
+  ghcr.io/ezhuk/pinetext:latest
+```
+
+Or using Docker Compose:
+
+```bash
+docker compose up
+```
+
+## License
+
+The server is licensed under the [MIT License](https://github.com/ezhuk/pinetext?tab=MIT-1-ov-file).

pinetext-0.1.7/codecov.yml

@@ -0,0 +1,3 @@
+comment: false
+github_checks:
+  annotations: false

pinetext-0.1.7/docker-compose.yml

@@ -0,0 +1,16 @@
+services:
+  pinetext:
+    build: .
+    container_name: pinetext
+    restart: unless-stopped
+    env_file:
+      - .env
+    environment:
+      - pinetext_pinecone__api_key=${pinetext_pinecone__api_key:-}
+      - pinetext_pinecone__assistant=${pinetext_pinecone__assistant:-assistant-name}
+      - pinetext_pinecone__model=${pinetext_pinecone__model:-o4-mini}
+      - pinetext_pinecone__data_dir=/app/data
+    volumes:
+      - ${pinetext_pinecone__data_dir:-./data}:/app/data
+    stdin_open: true
+    tty: true

pinetext-0.1.7/docs/docs.json

@@ -0,0 +1,32 @@
+{
+  "$schema": "https://mintlify.com/docs.json",
+  "colors": {
+    "primary": "#16A34A",
+    "light": "#07C983",
+    "dark": "#15803D"
+  },
+  "description": "",
+  "icons": {
+    "library": "lucide"
+  },
+  "name": "Docs",
+  "navigation": {
+    "dropdowns": [
+      {
+        "dropdown": "PineText Assistant",
+        "description": "Reason over documents",
+        "icon": "file-search",
+        "groups": [
+          {
+            "group": "Getting Started",
+            "pages": [
+              "pinetext/introduction",
+              "pinetext/installation"
+            ]
+          }
+        ]
+      }
+    ]
+  },
+  "theme": "maple"
+}

pinetext-0.1.7/docs/pinetext/installation.mdx

@@ -0,0 +1,53 @@
+---
+title: Installation
+icon: terminal
+---
+
+Use [uv](https://github.com/astral-sh/uv) to add and manage PineText as a dependency in your project, or install it directly via `uv pip install` or `pip install`. See the [Installation](https://github.com/ezhuk/modbus-mcp/blob/main/docs/modbus-mcp/installation.mdx) section of the documentation for full installation instructions and more details.
+
+```bash
+uv add pinetext
+```
+
+It can be embedded in and run directly from your application.
+
+```python
+# app.py
+from pinetext import PineText
+
+def main():
+    pt = PineText()
+    pt.run()
+```
+
+It can also be launched from the command line using the provided `CLI` without modifying the source code.
+
+```
+pinetext
+```
+
+Or in an ephemeral, isolated environment using `uvx`. Check out the [Using tools](https://docs.astral.sh/uv/guides/tools/) guide for more details.
+
+```bash
+uvx pinetext
+```
+
+## Configuration
+
+Place documents in the `data` folder and make sure to set `PINECONE_API_KEY` and the assistant name before starting PineText.
+
+```bash
+export PINETEXT_PINECONE__API_KEY=your-api-key
+export PINETEXT_PINECONE__ASSISTANT=assistant-name
+export PINETEXT_PINECONE__DATA_DIR=data
+export PINETEXT_PINECONE__MODEL=o4-mini
+```
+
+These settings can also be specified in a `.env` file in the working directory.
+
+```text
+pinetext_pinecone__api_key=your-api-key
+pinetext_pinecone__assistant=assistant-name
+pinetext_pinecone__data_dir=data
+pinetext_pinecone__model=o4-mini
+```

pinetext-0.1.7/docs/pinetext/introduction.mdx

@@ -0,0 +1,6 @@
+---
+title: Introduction
+icon: book-open
+---
+
+PineText is a lightweight assistant built using [Pinecone](https://docs.pinecone.io/guides/assistant/overview) that helps create RAG-based chat applications for reasoning over documents, retrieving relevant context, and providing grounded answers.

pinetext-0.1.7/pyproject.toml

@@ -0,0 +1,29 @@
+[project]
+name = "pinetext"
+version = "0.1.7"
+description = "PineText"
+readme = "README.md"
+requires-python = ">=3.13"
+dependencies = [
+    "pinecone>=8.0.0",
+    "pinecone-plugin-assistant>=3.0.0",
+    "pydantic-settings>=2.12.0",
+    "typer>=0.21.0",
+    "wandb>=0.23.1",
+    "weave>=0.52.23",
+]
+
+[project.scripts]
+pinetext = "pinetext.cli:app"
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[dependency-groups]
+dev = [
+    "pre-commit>=4.2.0",
+    "pytest>=8.4.1",
+    "pytest-cov>=6.2.1",
+    "ruff>=0.12.4",
+]

pinetext-0.1.7/src/pinetext/__init__.py

@@ -0,0 +1,7 @@
+from importlib.metadata import version
+
+from pinetext.client import PineText
+
+
+__version__ = version("pinetext")
+__all__ = ["PineText"]

pinetext-0.1.7/src/pinetext/cli.py

@@ -0,0 +1,15 @@
+import typer
+
+from pinetext.client import PineText
+
+
+app = typer.Typer(
+    name="PineText",
+    help="PineText CLI",
+)
+
+
+@app.command()
+def run():
+    client = PineText()
+    client.run()

pinetext-0.1.7/src/pinetext/client.py

@@ -0,0 +1,59 @@
+import wandb
+import weave
+
+from pathlib import Path
+
+from pinecone import Pinecone
+from pinecone_plugins.assistant.models.chat import Message
+
+from pinetext.settings import Settings
+
+
+settings = Settings()
+
+
+class PineText:
+    def __init__(self):
+        pass
+
+    def get_or_create_assistant(self, name: str):
+        try:
+            return self.pinecone.assistant.describe_assistant(assistant_name=name)
+        except Exception:
+            return self.pinecone.assistant.create_assistant(assistant_name=name)
+
+    def upload_files(self, path: str):
+        folder = Path(path)
+        if folder.is_dir():
+            uploaded = [x.name for x in self.assistant.list_files()]
+            for x in sorted(folder.iterdir()):
+                if x.name not in uploaded:
+                    self.assistant.upload_file(
+                        file_path=str(x.resolve()),
+                        metadata={
+                            "filename": x.name,
+                            "extension": x.suffix.lower().lstrip("."),
+                        },
+                        timeout=None,
+                    )
+
+    @weave.op()
+    def chat(self, text: str, model: str):
+        msg = Message(role="user", content=text)
+        resp = self.assistant.chat(messages=[msg], model=model)
+        return resp.message.content
+
+    def run(self):
+        if settings.wandb.api_key:
+            wandb.login(key=settings.wandb.api_key)
+            weave.init(settings.wandb.project)
+        self.pinecone = Pinecone(api_key=settings.pinecone.api_key)
+        self.assistant = self.get_or_create_assistant(settings.pinecone.assistant)
+        self.upload_files(settings.pinecone.data_dir)
+
+        while True:
+            text = input("> ").strip()
+            if text.lower() in ("exit", "quit"):
+                break
+            res = self.chat(text, settings.pinecone.model)
+            print(res)