pycodesage 0.1.0__tar.gz

pycodesage-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Keshav Ashiya
+
+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.

pycodesage-0.1.0/PKG-INFO

@@ -0,0 +1,242 @@
+Metadata-Version: 2.4
+Name: pycodesage
+Version: 0.1.0
+Summary: Local-first CLI code intelligence tool with LangChain-powered RAG
+Author: Keshav Ashiya
+License: MIT
+Keywords: code,ai,cli,devtools,rag,langchain
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: typer[all]>=0.9.0
+Requires-Dist: rich>=13.7.0
+Requires-Dist: langchain>=0.3.0
+Requires-Dist: langchain-community>=0.3.0
+Requires-Dist: langchain-ollama>=0.2.0
+Requires-Dist: langchain-chroma>=0.1.0
+Requires-Dist: chromadb>=0.4.0
+Requires-Dist: pyyaml>=6.0.0
+Requires-Dist: gitpython>=3.1.0
+Requires-Dist: numpy>=1.26.0
+Provides-Extra: openai
+Requires-Dist: langchain-openai>=0.1.0; extra == "openai"
+Provides-Extra: anthropic
+Requires-Dist: langchain-anthropic>=0.1.0; extra == "anthropic"
+Provides-Extra: multi-language
+Requires-Dist: tree-sitter>=0.20.0; extra == "multi-language"
+Provides-Extra: dev
+Requires-Dist: pytest>=7.4.0; extra == "dev"
+Requires-Dist: pytest-cov>=4.1.0; extra == "dev"
+Requires-Dist: pytest-asyncio>=0.21.0; extra == "dev"
+Requires-Dist: black>=23.12.0; extra == "dev"
+Requires-Dist: ruff>=0.1.8; extra == "dev"
+Requires-Dist: mypy>=1.7.0; extra == "dev"
+Provides-Extra: all
+Requires-Dist: codesage[anthropic,dev,multi-language,openai]; extra == "all"
+Dynamic: license-file
+
+# CodeSage
+
+**Local-first CLI code intelligence tool with LangChain-powered RAG**
+
+CodeSage indexes your codebase and enables semantic code search using AI. Everything runs locally on your machine with Ollama.
+
+## Features
+
+- **Semantic Code Search** - Find code using natural language queries
+- **AI-Powered Suggestions** - Get intelligent code recommendations from your codebase
+- **100% Local** - Everything runs on your machine with Ollama, no cloud required
+- **Fast Indexing** - Incremental updates only re-index changed files
+- **Python Support** - Full Python AST parsing
+
+## Requirements
+
+- **Python 3.9+**
+- **Ollama** - Local LLM runtime ([Install Ollama](https://ollama.ai))
+
+### Setting Up Ollama
+
+```bash
+# Install Ollama from https://ollama.ai, then pull required models:
+ollama pull qwen2.5-coder:7b      # For code analysis (~4.4GB)
+ollama pull mxbai-embed-large     # For embeddings (~670MB)
+```
+
+## Installation
+
+### From PyPI
+
+```bash
+pip install codesage
+```
+
+### From Source (Development)
+
+```bash
+# Clone the repository
+git clone https://github.com/keshavashiya/codesage.git
+cd codesage
+
+# Create virtual environment
+python -m venv venv
+source venv/bin/activate  # On Windows: venv\Scripts\activate
+
+# Install in development mode
+pip install -e ".[dev]"
+```
+
+### Optional: OpenAI/Anthropic Support
+
+```bash
+pip install codesage[openai]      # For OpenAI
+pip install codesage[anthropic]   # For Anthropic Claude
+```
+
+## Quick Start
+
+```bash
+# Navigate to your project
+cd your-project
+
+# Initialize CodeSage
+codesage init
+
+# Index the codebase
+codesage index
+
+# Search for code
+codesage suggest "function to validate email"
+```
+
+## Commands
+
+### `codesage init [PATH]`
+
+Initialize CodeSage in a project directory.
+
+```bash
+codesage init                              # Initialize in current directory
+codesage init /path/to/project             # Initialize in specific directory
+codesage init --model qwen2.5-coder:7b     # Specify LLM model
+codesage init --embedding-model mxbai-embed-large  # Specify embedding model
+```
+
+### `codesage index [PATH]`
+
+Index the codebase for semantic search.
+
+```bash
+codesage index                # Incremental index (only changed files)
+codesage index --full         # Force full reindex
+codesage index --clear        # Clear existing index before indexing
+```
+
+### `codesage suggest QUERY`
+
+Search for code using natural language.
+
+```bash
+codesage suggest "error handling"           # Search with default settings
+codesage suggest "database query" -n 10     # Return 10 results (default: 5)
+codesage suggest "auth logic" -s 0.5        # Set minimum similarity threshold
+codesage suggest "config" --no-explain      # Skip AI explanations (faster)
+codesage suggest "utils" -p /path/to/proj   # Search in specific project
+```
+
+### `codesage stats`
+
+Show index statistics.
+
+```bash
+codesage stats                # Show stats for current directory
+codesage stats /path/to/proj  # Show stats for specific project
+```
+
+### `codesage health`
+
+Check system health and dependencies.
+
+```bash
+codesage health               # Check Ollama, database, disk space
+```
+
+### `codesage version`
+
+Show CodeSage version.
+
+```bash
+codesage version
+```
+
+## Configuration
+
+Configuration is stored in `.codesage/config.yaml`:
+
+```yaml
+project_name: my-project
+language: python
+
+llm:
+  provider: ollama
+  model: qwen2.5-coder:7b
+  embedding_model: mxbai-embed-large
+  base_url: http://localhost:11434
+  temperature: 0.3
+  max_tokens: 500
+  request_timeout: 30.0
+  max_retries: 3
+
+storage:
+  vector_store: chromadb
+
+exclude_dirs:
+  - venv
+  - node_modules
+  - .git
+  - __pycache__
+```
+
+### Using OpenAI or Anthropic
+
+```bash
+export CODESAGE_API_KEY="your-api-key"
+```
+
+```yaml
+llm:
+  provider: openai           # or anthropic
+  model: gpt-4o-mini         # or claude-3-haiku-20240307
+```
+
+## Development
+
+```bash
+# Run tests
+pytest tests/ -v
+
+# Format code
+black codesage tests
+
+# Lint
+ruff check codesage
+```
+
+## Troubleshooting
+
+### "Ollama connection failed"
+
+```bash
+ollama serve  # Make sure Ollama is running
+```
+
+### "Model not found"
+
+```bash
+ollama pull qwen2.5-coder:7b
+ollama pull mxbai-embed-large
+```

pycodesage-0.1.0/README.md

@@ -0,0 +1,200 @@
+# CodeSage
+
+**Local-first CLI code intelligence tool with LangChain-powered RAG**
+
+CodeSage indexes your codebase and enables semantic code search using AI. Everything runs locally on your machine with Ollama.
+
+## Features
+
+- **Semantic Code Search** - Find code using natural language queries
+- **AI-Powered Suggestions** - Get intelligent code recommendations from your codebase
+- **100% Local** - Everything runs on your machine with Ollama, no cloud required
+- **Fast Indexing** - Incremental updates only re-index changed files
+- **Python Support** - Full Python AST parsing
+
+## Requirements
+
+- **Python 3.9+**
+- **Ollama** - Local LLM runtime ([Install Ollama](https://ollama.ai))
+
+### Setting Up Ollama
+
+```bash
+# Install Ollama from https://ollama.ai, then pull required models:
+ollama pull qwen2.5-coder:7b      # For code analysis (~4.4GB)
+ollama pull mxbai-embed-large     # For embeddings (~670MB)
+```
+
+## Installation
+
+### From PyPI
+
+```bash
+pip install codesage
+```
+
+### From Source (Development)
+
+```bash
+# Clone the repository
+git clone https://github.com/keshavashiya/codesage.git
+cd codesage
+
+# Create virtual environment
+python -m venv venv
+source venv/bin/activate  # On Windows: venv\Scripts\activate
+
+# Install in development mode
+pip install -e ".[dev]"
+```
+
+### Optional: OpenAI/Anthropic Support
+
+```bash
+pip install codesage[openai]      # For OpenAI
+pip install codesage[anthropic]   # For Anthropic Claude
+```
+
+## Quick Start
+
+```bash
+# Navigate to your project
+cd your-project
+
+# Initialize CodeSage
+codesage init
+
+# Index the codebase
+codesage index
+
+# Search for code
+codesage suggest "function to validate email"
+```
+
+## Commands
+
+### `codesage init [PATH]`
+
+Initialize CodeSage in a project directory.
+
+```bash
+codesage init                              # Initialize in current directory
+codesage init /path/to/project             # Initialize in specific directory
+codesage init --model qwen2.5-coder:7b     # Specify LLM model
+codesage init --embedding-model mxbai-embed-large  # Specify embedding model
+```
+
+### `codesage index [PATH]`
+
+Index the codebase for semantic search.
+
+```bash
+codesage index                # Incremental index (only changed files)
+codesage index --full         # Force full reindex
+codesage index --clear        # Clear existing index before indexing
+```
+
+### `codesage suggest QUERY`
+
+Search for code using natural language.
+
+```bash
+codesage suggest "error handling"           # Search with default settings
+codesage suggest "database query" -n 10     # Return 10 results (default: 5)
+codesage suggest "auth logic" -s 0.5        # Set minimum similarity threshold
+codesage suggest "config" --no-explain      # Skip AI explanations (faster)
+codesage suggest "utils" -p /path/to/proj   # Search in specific project
+```
+
+### `codesage stats`
+
+Show index statistics.
+
+```bash
+codesage stats                # Show stats for current directory
+codesage stats /path/to/proj  # Show stats for specific project
+```
+
+### `codesage health`
+
+Check system health and dependencies.
+
+```bash
+codesage health               # Check Ollama, database, disk space
+```
+
+### `codesage version`
+
+Show CodeSage version.
+
+```bash
+codesage version
+```
+
+## Configuration
+
+Configuration is stored in `.codesage/config.yaml`:
+
+```yaml
+project_name: my-project
+language: python
+
+llm:
+  provider: ollama
+  model: qwen2.5-coder:7b
+  embedding_model: mxbai-embed-large
+  base_url: http://localhost:11434
+  temperature: 0.3
+  max_tokens: 500
+  request_timeout: 30.0
+  max_retries: 3
+
+storage:
+  vector_store: chromadb
+
+exclude_dirs:
+  - venv
+  - node_modules
+  - .git
+  - __pycache__
+```
+
+### Using OpenAI or Anthropic
+
+```bash
+export CODESAGE_API_KEY="your-api-key"
+```
+
+```yaml
+llm:
+  provider: openai           # or anthropic
+  model: gpt-4o-mini         # or claude-3-haiku-20240307
+```
+
+## Development
+
+```bash
+# Run tests
+pytest tests/ -v
+
+# Format code
+black codesage tests
+
+# Lint
+ruff check codesage
+```
+
+## Troubleshooting
+
+### "Ollama connection failed"
+
+```bash
+ollama serve  # Make sure Ollama is running
+```
+
+### "Model not found"
+
+```bash
+ollama pull qwen2.5-coder:7b
+ollama pull mxbai-embed-large
+```

pycodesage-0.1.0/codesage/__init__.py

@@ -0,0 +1,4 @@
+"""CodeSage: Local-first CLI code intelligence tool."""
+
+__version__ = "0.1.0"
+__author__ = "Keshav Ashiya"

pycodesage-0.1.0/codesage/__main__.py

@@ -0,0 +1,6 @@
+"""Allow running as python -m codesage."""
+
+from codesage.cli.main import app
+
+if __name__ == "__main__":
+    app()

pycodesage-0.1.0/codesage/cli/__init__.py

@@ -0,0 +1,5 @@
+"""CLI package exports."""
+
+from codesage.cli.main import app
+
+__all__ = ["app"]