kodit 0.1.15__tar.gz → 0.1.17__tar.gz

kodit-0.1.17/.github/workflows/pull_request.yaml

@@ -0,0 +1,35 @@
+# This workflow will install dependencies, create coverage tests and run Pytest Coverage Comment
+# For more information see: https://github.com/MishaKav/pytest-coverage-comment/
+name: pytest-coverage-comment
+on:
+  pull_request:
+    branches:
+      - "*"
+
+# https://docs.github.com/en/actions/using-jobs/assigning-permissions-to-jobs
+# `contents` is for permission to the contents of the repository.
+# `pull-requests` is for permission to pull request
+permissions:
+  contents: write
+  checks: write
+  pull-requests: write
+
+jobs:
+  coverage-comment:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version-file: ".python-version"
+      - uses: astral-sh/setup-uv@v5
+      - run: uv sync --locked --all-extras --dev
+
+      - name: Run tests
+        run: uv run pytest --junitxml=pytest.xml --cov-report=term-missing:skip-covered --cov=src tests/kodit | tee pytest-coverage.txt
+
+      - name: Pytest coverage comment
+        uses: MishaKav/pytest-coverage-comment@main
+        with:
+          pytest-coverage-path: ./pytest-coverage.txt
+          junitxml-path: ./pytest.xml

{kodit-0.1.15 → kodit-0.1.17}/.github/workflows/test.yaml

@@ -9,7 +9,6 @@ on:
 permissions:
   contents: read # Needed to check out code
   checks: write # Needed to report test results
-  pull-requests: write # Needed to add comments/annotations to PRs
 
 jobs:
   test:
@@ -37,12 +36,6 @@ jobs:
       - name: Run tests
         run: uv run pytest -s --cov=src --cov-report=xml tests/kodit
 
-      - name: Pytest coverage comment
-        if: github.event_name == 'pull_request'
-        uses: MishaKav/pytest-coverage-comment@v1.1.54
-        with:
-          pytest-xml-coverage-path: ./coverage.xml
-
   build-package:
     runs-on: ubuntu-latest
     timeout-minutes: 10
@@ -69,12 +62,18 @@ jobs:
   test-package:
     needs: build-package
     runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version:
+          - 3.12
+          - 3.13
     timeout-minutes: 10
     steps:
       - uses: actions/checkout@v4
         with:
           sparse-checkout: |
             tests/smoke.sh
+            uv.lock
           sparse-checkout-cone-mode: false
 
       - name: Download built package
@@ -86,7 +85,7 @@ jobs:
       - name: "Set up Python"
         uses: actions/setup-python@v5
         with:
-          python-version: 3.12
+          python-version: ${{ matrix.python-version }}
 
       - name: Install uv
         uses: astral-sh/setup-uv@v5

kodit-0.1.17/.python-version

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

{kodit-0.1.15 → kodit-0.1.17}/Dockerfile

@@ -1,5 +1,5 @@
 # syntax=docker/dockerfile:1.9
-FROM python:3.12.10-slim-bookworm AS build
+FROM python:3.13.3-slim-bookworm AS build
 
 # The following does not work in Podman unless you build in Docker
 # compatibility mode: <https://github.com/containers/podman/issues/8477>
@@ -23,12 +23,12 @@ COPY --from=ghcr.io/astral-sh/uv:0.7.2 /uv /usr/local/bin/uv
 # - Silence uv complaining about not being able to use hard links,
 # - tell uv to byte-compile packages for faster application startups,
 # - prevent uv from accidentally downloading isolated Python builds,
-# - pick a Python (use `/usr/bin/python3.12` on uv 0.5.0 and later),
+# - pick a Python (use `/usr/bin/python3.13` on uv 0.5.0 and later),
 # - and finally declare `/app` as the target for `uv sync`.
 ENV UV_LINK_MODE=copy \
     UV_COMPILE_BYTECODE=1 \
     UV_PYTHON_DOWNLOADS=never \
-    UV_PYTHON=python3.12 \
+    UV_PYTHON=python3.13 \
     UV_PROJECT_ENVIRONMENT=/app
 
 # Synchronize DEPENDENCIES without the application itself.
@@ -60,7 +60,7 @@ RUN --mount=type=cache,target=/root/.cache \
 
 ##########################################################################
 
-FROM python:3.12.10-slim-bookworm
+FROM python:3.13.3-slim-bookworm
 SHELL ["sh", "-exc"]
 
 ENV PATH=/app/bin:$PATH

kodit-0.1.17/PKG-INFO

@@ -0,0 +1,152 @@
+Metadata-Version: 2.4
+Name: kodit
+Version: 0.1.17
+Summary: Code indexing for better AI code generation
+Project-URL: Homepage, https://docs.helixml.tech/kodit/
+Project-URL: Documentation, https://docs.helixml.tech/kodit/
+Project-URL: Repository, https://github.com/helixml/kodit.git
+Project-URL: Issues, https://github.com/helixml/kodit/issues
+Project-URL: Changelog, https://github.com/helixml/kodit/releases
+Author-email: "Helix.ML" <founders@helix.ml>
+Maintainer-email: "Helix.ML" <founders@helix.ml>
+License-Expression: Apache-2.0
+License-File: LICENSE
+Keywords: ai,indexing,mcp,rag
+Classifier: Development Status :: 2 - Pre-Alpha
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development :: Code Generators
+Requires-Python: >=3.12
+Requires-Dist: aiofiles>=24.1.0
+Requires-Dist: aiosqlite>=0.20.0
+Requires-Dist: alembic>=1.15.2
+Requires-Dist: asgi-correlation-id>=4.3.4
+Requires-Dist: asyncpg>=0.30.0
+Requires-Dist: better-exceptions>=0.3.3
+Requires-Dist: bm25s[core]>=0.2.12
+Requires-Dist: click>=8.1.8
+Requires-Dist: colorama>=0.4.6
+Requires-Dist: dotenv>=0.9.9
+Requires-Dist: fastapi[standard]>=0.115.12
+Requires-Dist: fastmcp>=2.3.3
+Requires-Dist: gitpython>=3.1.44
+Requires-Dist: hf-xet>=1.1.2
+Requires-Dist: httpx-retries>=0.3.2
+Requires-Dist: httpx>=0.28.1
+Requires-Dist: openai>=1.82.0
+Requires-Dist: posthog>=4.0.1
+Requires-Dist: pydantic-settings>=2.9.1
+Requires-Dist: pytable-formatter>=0.1.1
+Requires-Dist: sentence-transformers>=4.1.0
+Requires-Dist: sqlalchemy[asyncio]>=2.0.40
+Requires-Dist: structlog>=25.3.0
+Requires-Dist: tdqm>=0.0.1
+Requires-Dist: tiktoken>=0.9.0
+Requires-Dist: transformers>=4.51.3
+Requires-Dist: tree-sitter-language-pack>=0.7.3
+Requires-Dist: tree-sitter>=0.24.0
+Requires-Dist: uritools>=5.0.0
+Description-Content-Type: text/markdown
+
+<p align="center">
+    <a href="https://docs.helix.ml/kodit/"><img src="https://docs.helix.ml/images/helix-kodit-logo.png" alt="Helix Kodit Logo" width="300"></a>
+</p>
+
+<h1 align="center">
+Kodit: A Code Indexing MCP Server
+</h1>
+
+<p align="center">
+Kodit connects your AI coding assistant to external codebases to provide accurate and up-to-date snippets of code.
+</p>
+
+<div align="center">
+
+[![Documentation](https://img.shields.io/badge/Documentation-6B46C1?style=for-the-badge&logo=readthedocs&logoColor=white)](https://docs.helix.ml/kodit/)
+[![License](https://img.shields.io/badge/License-Apache%202.0-blue.svg?style=for-the-badge)](./LICENSE)
+[![Discussions](https://img.shields.io/badge/Discussions-181717?style=for-the-badge&logo=github&logoColor=white)](https://github.com/helixml/kodit/discussions)
+
+</div>
+
+**Helix Kodit** is an **MCP server** that connects your AI coding assistant to external codebases. It can:
+
+- Improve your AI-assisted code by providing canonical examples direct from the source
+- Index local and public codebases
+- Integrates with any AI coding assistant via MCP
+- Search using keyword and semantic search
+- Integrate with any OpenAI-compatible or custom API/model
+
+If you're an engineer working with AI-powered coding assistants, Kodit helps by
+providing relevant and up-to-date examples of your task so that LLMs make less mistakes
+and produce fewer hallucinations.
+
+## ✨ Features
+
+### Codebase Indexing
+
+Kodit connects to a variety of local and remote codebases to build an index of your
+code. This index is used to build a snippet library, ready for ingestion into an LLM.
+
+- Index local directories and public Git repositories
+- Build comprehensive snippet libraries for LLM ingestion
+- Support for multiple codebase types and languages
+- Efficient indexing and search capabilities
+
+### MCP Server
+
+Relevant snippets are exposed to an AI coding assistant via an MCP server. This allows
+the assistant to request relevant snippets by providing keywords, code, and semantic
+intent. Kodit has been tested to work well with:
+
+- Seamless integration with popular AI coding assistants
+- Tested and verified with:
+  - [Cursor](https://docs.helix.ml/kodit/#integration-with-cursor)
+  - [Cline](https://docs.helix.ml/kodit/#integration-with-cline)
+- Please contribute more instructions! ... any other assistant is likely to work ...
+
+### Enterprise Ready
+
+Out of the box, Kodit works with a local SQLite database and very small, local models.
+But enterprises can scale out with performant databases and dedicated models. Everything
+can even run securely, privately, with on-premise LLM platforms like
+[Helix](https://helix.ml).
+
+Supported databases:
+
+- SQLite
+- [Vectorchord](https://github.com/tensorchord/VectorChord)
+
+Supported providers:
+
+- Local (which uses tiny CPU-only open-source models)
+- OpenAI
+- Secure, private LLM enclave with [Helix](https://helix.ml).
+- Any other OpenAI compatible API
+
+## 🚀 Quick Start
+
+1. [Install Kodit](https://docs.helix.ml/kodit/#installation)
+2. [Index codebases](https://docs.helix.ml/kodit/#quick-start)
+3. [Integrate with your coding assistant](https://docs.helix.ml/kodit/#integrating-kodit-with-coding-assistants)
+
+### Documentation
+
+- [Installation Guide](https://docs.helix.ml/kodit/#installation)
+- [Usage Guide](https://docs.helix.ml/kodit/#quick-start)
+- [Connecting to Kodit](https://docs.helix.ml/kodit/#integrating-kodit-with-coding-assistants)
+- [Configuration Options](https://docs.helix.ml/kodit/#configuring-kodit)
+- [Contribution Guidelines](.github/CONTRIBUTING.md)
+
+## Roadmap
+
+The roadmap is currently maintained as a [Github Project](https://github.com/orgs/helixml/projects/4).
+
+## 💬 Support
+
+For commercial support, please contact [Helix.ML](founders@helix.ml). To ask a question,
+please [open a discussion](https://github.com/helixml/kodit/discussions).
+
+## License
+
+[Apache 2.0 © 2025 HelixML, Inc.](./LICENSE)

kodit-0.1.17/README.md

@@ -0,0 +1,101 @@
+<p align="center">
+    <a href="https://docs.helix.ml/kodit/"><img src="https://docs.helix.ml/images/helix-kodit-logo.png" alt="Helix Kodit Logo" width="300"></a>
+</p>
+
+<h1 align="center">
+Kodit: A Code Indexing MCP Server
+</h1>
+
+<p align="center">
+Kodit connects your AI coding assistant to external codebases to provide accurate and up-to-date snippets of code.
+</p>
+
+<div align="center">
+
+[![Documentation](https://img.shields.io/badge/Documentation-6B46C1?style=for-the-badge&logo=readthedocs&logoColor=white)](https://docs.helix.ml/kodit/)
+[![License](https://img.shields.io/badge/License-Apache%202.0-blue.svg?style=for-the-badge)](./LICENSE)
+[![Discussions](https://img.shields.io/badge/Discussions-181717?style=for-the-badge&logo=github&logoColor=white)](https://github.com/helixml/kodit/discussions)
+
+</div>
+
+**Helix Kodit** is an **MCP server** that connects your AI coding assistant to external codebases. It can:
+
+- Improve your AI-assisted code by providing canonical examples direct from the source
+- Index local and public codebases
+- Integrates with any AI coding assistant via MCP
+- Search using keyword and semantic search
+- Integrate with any OpenAI-compatible or custom API/model
+
+If you're an engineer working with AI-powered coding assistants, Kodit helps by
+providing relevant and up-to-date examples of your task so that LLMs make less mistakes
+and produce fewer hallucinations.
+
+## ✨ Features
+
+### Codebase Indexing
+
+Kodit connects to a variety of local and remote codebases to build an index of your
+code. This index is used to build a snippet library, ready for ingestion into an LLM.
+
+- Index local directories and public Git repositories
+- Build comprehensive snippet libraries for LLM ingestion
+- Support for multiple codebase types and languages
+- Efficient indexing and search capabilities
+
+### MCP Server
+
+Relevant snippets are exposed to an AI coding assistant via an MCP server. This allows
+the assistant to request relevant snippets by providing keywords, code, and semantic
+intent. Kodit has been tested to work well with:
+
+- Seamless integration with popular AI coding assistants
+- Tested and verified with:
+  - [Cursor](https://docs.helix.ml/kodit/#integration-with-cursor)
+  - [Cline](https://docs.helix.ml/kodit/#integration-with-cline)
+- Please contribute more instructions! ... any other assistant is likely to work ...
+
+### Enterprise Ready
+
+Out of the box, Kodit works with a local SQLite database and very small, local models.
+But enterprises can scale out with performant databases and dedicated models. Everything
+can even run securely, privately, with on-premise LLM platforms like
+[Helix](https://helix.ml).
+
+Supported databases:
+
+- SQLite
+- [Vectorchord](https://github.com/tensorchord/VectorChord)
+
+Supported providers:
+
+- Local (which uses tiny CPU-only open-source models)
+- OpenAI
+- Secure, private LLM enclave with [Helix](https://helix.ml).
+- Any other OpenAI compatible API
+
+## 🚀 Quick Start
+
+1. [Install Kodit](https://docs.helix.ml/kodit/#installation)
+2. [Index codebases](https://docs.helix.ml/kodit/#quick-start)
+3. [Integrate with your coding assistant](https://docs.helix.ml/kodit/#integrating-kodit-with-coding-assistants)
+
+### Documentation
+
+- [Installation Guide](https://docs.helix.ml/kodit/#installation)
+- [Usage Guide](https://docs.helix.ml/kodit/#quick-start)
+- [Connecting to Kodit](https://docs.helix.ml/kodit/#integrating-kodit-with-coding-assistants)
+- [Configuration Options](https://docs.helix.ml/kodit/#configuring-kodit)
+- [Contribution Guidelines](.github/CONTRIBUTING.md)
+
+## Roadmap
+
+The roadmap is currently maintained as a [Github Project](https://github.com/orgs/helixml/projects/4).
+
+## 💬 Support
+
+For commercial support, please contact [Helix.ML](founders@helix.ml). To ask a question,
+please [open a discussion](https://github.com/helixml/kodit/discussions).
+
+## License
+
+[Apache 2.0 © 2025 HelixML, Inc.](./LICENSE)

{kodit-0.1.15 → kodit-0.1.17}/docs/_index.md

@@ -169,7 +169,7 @@ recreate all indexes.
 
 ### Indexing
 
-#### Default Provider
+#### Default Indexing Provider
 
 By default, Kodit will use small local models for semantic search and enrichment. If you
 are using Kodit in a professional capacity, it is likely that the local model latency is
@@ -247,6 +247,12 @@ DB_URL=postgresql+asyncpg://postgres:mysecretpassword@localhost:5432/kodit
 DEFAULT_SEARCH_PROVIDER=vectorchord
 ```
 
+### Enrichment
+
+#### Default Enrichment Provider
+
+The default enrichment provider is the same as [the default indexing provider](#default-indexing-provider).
+
 ## Managing Kodit
 
 There is limited management functionality at this time. To delete indexes you must

kodit-0.1.17/docs/demos/_index.md

@@ -0,0 +1,13 @@
+---
+title: Kodit Demos
+linkTitle: Demos
+weight: 4
+tags:
+- demo
+---
+
+The following sections provide lots of examples and demos of using Kodit.
+
+<!--more-->
+
+{{< default-section-cards-list >}}