tzamuncode 0.1.0__tar.gz

tzamuncode-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Tzamun Arabia IT Co.
+
+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.

tzamuncode-0.1.0/PKG-INFO

@@ -0,0 +1,200 @@
+Metadata-Version: 2.4
+Name: tzamuncode
+Version: 0.1.0
+Summary: TzamunCode - AI Coding Assistant powered by local models
+Author-email: "Tzamun Arabia IT Co." <info@tzamun.com>
+License: MIT
+Project-URL: Homepage, https://tzamun.com
+Project-URL: Documentation, https://docs.tzamun.com/tzamuncode
+Project-URL: Repository, https://github.com/tzamun/tzamuncode-cli
+Keywords: ai,coding,assistant,ollama,cli
+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
+Classifier: Programming Language :: Python :: 3.11
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: typer>=0.9.0
+Requires-Dist: rich>=13.0.0
+Requires-Dist: textual>=0.40.0
+Requires-Dist: readchar>=4.0.0
+Requires-Dist: langchain>=0.1.0
+Requires-Dist: langchain-community>=0.0.10
+Requires-Dist: openai>=1.0.0
+Requires-Dist: requests>=2.31.0
+Requires-Dist: gitpython>=3.1.40
+Requires-Dist: pathspec>=0.11.0
+Requires-Dist: tiktoken>=0.5.0
+Requires-Dist: prompt-toolkit>=3.0.0
+Provides-Extra: dev
+Requires-Dist: pytest>=7.4.0; extra == "dev"
+Requires-Dist: black>=23.0.0; extra == "dev"
+Requires-Dist: ruff>=0.1.0; extra == "dev"
+Requires-Dist: mypy>=1.5.0; extra == "dev"
+Dynamic: license-file
+
+# TzamunCode CLI 🚀
+
+> AI Coding Assistant powered by local models - Built in Saudi Arabia 🇸🇦
+
+**TzamunCode** is a privacy-first AI coding assistant that runs entirely on your local infrastructure using Ollama and vLLM. No cloud dependencies, no API costs, complete control.
+
+## ✨ Features
+
+- 🤖 **Agentic AI** - Multi-step planning and execution
+- 📝 **Code Generation** - Create files, functions, and entire projects
+- ✏️ **Multi-file Editing** - Edit multiple files in one operation
+- 🔧 **Tool Calling** - Git operations, file search, command execution
+- 🎯 **Context Aware** - Understands your project structure
+- 🔒 **Privacy First** - Everything runs locally
+- ⚡ **Fast** - Powered by vLLM for optimized inference
+- 🌍 **Multi-model** - Use any Ollama model (15+ available)
+
+## 🚀 Quick Start
+
+### Installation
+
+```bash
+# Clone the repository
+git clone https://github.com/tzamun/tzamuncode-cli.git
+cd tzamuncode-cli
+
+# Install
+pip install -e .
+
+# Or install from PyPI (when published)
+pip install tzamuncode
+```
+
+### Prerequisites
+
+- Python 3.9+
+- Ollama running locally (http://localhost:11434)
+- At least one Ollama model installed
+
+### Basic Usage
+
+```bash
+# Start interactive chat
+tzamuncode chat
+
+# Generate code
+tzamuncode generate "Create a Flask REST API with authentication"
+
+# Edit a file
+tzamuncode edit app.py "Add error handling to all routes"
+
+# Explain code
+tzamuncode explain main.py
+
+# Quick alias
+tzc chat
+```
+
+## 📖 Documentation
+
+### Commands
+
+#### `chat` - Interactive Chat
+```bash
+tzamuncode chat
+tzamuncode chat --model qwen2.5:32b
+```
+
+#### `generate` - Code Generation
+```bash
+tzamuncode generate "Create a Python web scraper"
+tzamuncode generate "Add unit tests for user.py" --output tests/
+```
+
+#### `edit` - File Editing
+```bash
+tzamuncode edit app.py "Refactor to use async/await"
+tzamuncode edit . "Add type hints to all functions"
+```
+
+#### `explain` - Code Explanation
+```bash
+tzamuncode explain complex_function.py
+tzamuncode explain --detailed auth.py
+```
+
+#### `review` - Code Review
+```bash
+tzamuncode review pull_request.diff
+tzamuncode review --strict src/
+```
+
+### Configuration
+
+Create `~/.tzamuncode/config.yaml`:
+
+```yaml
+# Default model
+model: qwen2.5:32b
+
+# Ollama settings
+ollama:
+  base_url: http://localhost:11434
+  timeout: 120
+
+# vLLM settings (optional, for faster inference)
+vllm:
+  enabled: true
+  base_url: http://localhost:8000
+  model: deepseek-coder-7b
+
+# Preferences
+preferences:
+  show_diff: true
+  auto_apply: false
+  max_context: 64000
+  temperature: 0.7
+```
+
+## 🏗️ Architecture
+
+```
+┌─────────────────────────────────────┐
+│     TzamunCode CLI                  │
+│  (Typer + Rich UI)                  │
+└─────────────────────────────────────┘
+           ↓
+┌─────────────────────────────────────┐
+│   Agentic Layer (LangChain)         │
+│  - Multi-step planning              │
+│  - Tool calling                     │
+│  - Context management               │
+└─────────────────────────────────────┘
+           ↓
+┌─────────────────────────────────────┐
+│   AI Backend                        │
+│  - Ollama (15+ models)              │
+│  - vLLM (fast inference)            │
+└─────────────────────────────────────┘
+```
+
+## 🤝 Contributing
+
+We welcome contributions! See [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines.
+
+## 📄 License
+
+MIT License - see [LICENSE](LICENSE) for details.
+
+## 🌟 Built by Tzamun Arabia IT Co.
+
+**TzamunCode** is part of the Tzamun AI ecosystem:
+- **TzamunAI** - AI platform with 15+ models
+- **TzamunERP** - ERPNext + AI integration
+- **Auxly** - AI coding assistant for IDEs
+- **AccessHub** - Privileged Access Management
+
+Visit [tzamun.com](https://tzamun.com) to learn more.
+
+---
+
+Made with ❤️ in Saudi Arabia 🇸🇦

tzamuncode-0.1.0/README.md

@@ -0,0 +1,162 @@
+# TzamunCode CLI 🚀
+
+> AI Coding Assistant powered by local models - Built in Saudi Arabia 🇸🇦
+
+**TzamunCode** is a privacy-first AI coding assistant that runs entirely on your local infrastructure using Ollama and vLLM. No cloud dependencies, no API costs, complete control.
+
+## ✨ Features
+
+- 🤖 **Agentic AI** - Multi-step planning and execution
+- 📝 **Code Generation** - Create files, functions, and entire projects
+- ✏️ **Multi-file Editing** - Edit multiple files in one operation
+- 🔧 **Tool Calling** - Git operations, file search, command execution
+- 🎯 **Context Aware** - Understands your project structure
+- 🔒 **Privacy First** - Everything runs locally
+- ⚡ **Fast** - Powered by vLLM for optimized inference
+- 🌍 **Multi-model** - Use any Ollama model (15+ available)
+
+## 🚀 Quick Start
+
+### Installation
+
+```bash
+# Clone the repository
+git clone https://github.com/tzamun/tzamuncode-cli.git
+cd tzamuncode-cli
+
+# Install
+pip install -e .
+
+# Or install from PyPI (when published)
+pip install tzamuncode
+```
+
+### Prerequisites
+
+- Python 3.9+
+- Ollama running locally (http://localhost:11434)
+- At least one Ollama model installed
+
+### Basic Usage
+
+```bash
+# Start interactive chat
+tzamuncode chat
+
+# Generate code
+tzamuncode generate "Create a Flask REST API with authentication"
+
+# Edit a file
+tzamuncode edit app.py "Add error handling to all routes"
+
+# Explain code
+tzamuncode explain main.py
+
+# Quick alias
+tzc chat
+```
+
+## 📖 Documentation
+
+### Commands
+
+#### `chat` - Interactive Chat
+```bash
+tzamuncode chat
+tzamuncode chat --model qwen2.5:32b
+```
+
+#### `generate` - Code Generation
+```bash
+tzamuncode generate "Create a Python web scraper"
+tzamuncode generate "Add unit tests for user.py" --output tests/
+```
+
+#### `edit` - File Editing
+```bash
+tzamuncode edit app.py "Refactor to use async/await"
+tzamuncode edit . "Add type hints to all functions"
+```
+
+#### `explain` - Code Explanation
+```bash
+tzamuncode explain complex_function.py
+tzamuncode explain --detailed auth.py
+```
+
+#### `review` - Code Review
+```bash
+tzamuncode review pull_request.diff
+tzamuncode review --strict src/
+```
+
+### Configuration
+
+Create `~/.tzamuncode/config.yaml`:
+
+```yaml
+# Default model
+model: qwen2.5:32b
+
+# Ollama settings
+ollama:
+  base_url: http://localhost:11434
+  timeout: 120
+
+# vLLM settings (optional, for faster inference)
+vllm:
+  enabled: true
+  base_url: http://localhost:8000
+  model: deepseek-coder-7b
+
+# Preferences
+preferences:
+  show_diff: true
+  auto_apply: false
+  max_context: 64000
+  temperature: 0.7
+```
+
+## 🏗️ Architecture
+
+```
+┌─────────────────────────────────────┐
+│     TzamunCode CLI                  │
+│  (Typer + Rich UI)                  │
+└─────────────────────────────────────┘
+           ↓
+┌─────────────────────────────────────┐
+│   Agentic Layer (LangChain)         │
+│  - Multi-step planning              │
+│  - Tool calling                     │
+│  - Context management               │
+└─────────────────────────────────────┘
+           ↓
+┌─────────────────────────────────────┐
+│   AI Backend                        │
+│  - Ollama (15+ models)              │
+│  - vLLM (fast inference)            │
+└─────────────────────────────────────┘
+```
+
+## 🤝 Contributing
+
+We welcome contributions! See [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines.
+
+## 📄 License
+
+MIT License - see [LICENSE](LICENSE) for details.
+
+## 🌟 Built by Tzamun Arabia IT Co.
+
+**TzamunCode** is part of the Tzamun AI ecosystem:
+- **TzamunAI** - AI platform with 15+ models
+- **TzamunERP** - ERPNext + AI integration
+- **Auxly** - AI coding assistant for IDEs
+- **AccessHub** - Privileged Access Management
+
+Visit [tzamun.com](https://tzamun.com) to learn more.
+
+---
+
+Made with ❤️ in Saudi Arabia 🇸🇦

tzamuncode-0.1.0/pyproject.toml

@@ -0,0 +1,55 @@
+[build-system]
+requires = ["setuptools>=68.0", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "tzamuncode"
+version = "0.1.0"
+description = "TzamunCode - AI Coding Assistant powered by local models"
+authors = [
+    {name = "Tzamun Arabia IT Co.", email = "info@tzamun.com"}
+]
+readme = "README.md"
+requires-python = ">=3.9"
+license = {text = "MIT"}
+keywords = ["ai", "coding", "assistant", "ollama", "cli"]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3.9",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+]
+
+dependencies = [
+    "typer>=0.9.0",
+    "rich>=13.0.0",
+    "textual>=0.40.0",
+    "readchar>=4.0.0",
+    "langchain>=0.1.0",
+    "langchain-community>=0.0.10",
+    "openai>=1.0.0",
+    "requests>=2.31.0",
+    "gitpython>=3.1.40",
+    "pathspec>=0.11.0",
+    "tiktoken>=0.5.0",
+    "prompt-toolkit>=3.0.0",
+]
+
+[project.optional-dependencies]
+dev = [
+    "pytest>=7.4.0",
+    "black>=23.0.0",
+    "ruff>=0.1.0",
+    "mypy>=1.5.0",
+]
+
+[project.scripts]
+tzamuncode = "tzamuncode.cli.main:app"
+tzc = "tzamuncode.cli.main:app"
+
+[project.urls]
+Homepage = "https://tzamun.com"
+Documentation = "https://docs.tzamun.com/tzamuncode"
+Repository = "https://github.com/tzamun/tzamuncode-cli"

tzamuncode-0.1.0/setup.cfg

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

tzamuncode-0.1.0/tzamuncode/__init__.py

@@ -0,0 +1,10 @@
+"""
+TzamunCode - AI Coding Assistant
+
+Privacy-first AI coding assistant powered by local models.
+Built by Tzamun Arabia IT Co. 🇸🇦
+"""
+
+__version__ = "0.1.0"
+__author__ = "Tzamun Arabia IT Co."
+__email__ = "info@tzamun.com"

tzamuncode-0.1.0/tzamuncode/agents/__init__.py

@@ -0,0 +1 @@
+"""Agentic AI module for TzamunCode"""

tzamuncode-0.1.0/tzamuncode/agents/coder.py

@@ -0,0 +1,144 @@
+"""
+Agentic Coder - Advanced AI coding agent with file access and tool calling
+"""
+
+from typing import List, Dict, Optional, Any
+from pathlib import Path
+import json
+
+from langchain.agents import initialize_agent, Tool, AgentType
+from langchain.memory import ConversationBufferMemory
+from langchain_community.llms import Ollama
+
+from ..utils.file_ops import FileManager
+from ..utils.project_scanner import ProjectScanner
+from .tools import create_tools
+
+
+class AgenticCoder:
+    """
+    Advanced AI coding agent with file access and autonomous capabilities.
+    
+    Similar to Claude Code, this agent can:
+    - Read and write files autonomously
+    - Scan project structure
+    - Edit multiple files
+    - Execute git operations
+    - Search codebase
+    - Plan multi-step tasks
+    """
+    
+    def __init__(
+        self,
+        model: str = "qwen2.5:32b",
+        base_url: str = "http://localhost:11434",
+        workspace: Optional[str] = None
+    ):
+        self.model = model
+        self.base_url = base_url
+        self.workspace = Path(workspace) if workspace else Path.cwd()
+        
+        # Initialize components
+        self.file_manager = FileManager()
+        self.project_scanner = ProjectScanner(self.workspace)
+        
+        # Initialize LLM
+        self.llm = Ollama(
+            model=model,
+            base_url=base_url,
+            temperature=0.7
+        )
+        
+        # Create tools
+        self.tools = create_tools(
+            file_manager=self.file_manager,
+            project_scanner=self.project_scanner,
+            workspace=self.workspace
+        )
+        
+        # Initialize memory
+        self.memory = ConversationBufferMemory(
+            memory_key="chat_history",
+            return_messages=True
+        )
+        
+        # Initialize agent
+        self.agent = initialize_agent(
+            tools=self.tools,
+            llm=self.llm,
+            agent=AgentType.STRUCTURED_CHAT_ZERO_SHOT_REACT_DESCRIPTION,
+            verbose=True,
+            memory=self.memory,
+            handle_parsing_errors=True,
+            max_iterations=10
+        )
+    
+    def execute(self, instruction: str) -> Dict[str, Any]:
+        """
+        Execute an instruction using the agentic AI.
+        
+        The agent will autonomously:
+        - Scan project if needed
+        - Read relevant files
+        - Plan the changes
+        - Edit multiple files
+        - Provide summary
+        
+        Args:
+            instruction: What to do (e.g., "Add authentication to this Flask app")
+        
+        Returns:
+            Dict with result, files_changed, and summary
+        """
+        # Add context about workspace
+        context = f"""You are working in: {self.workspace}
+
+Available tools:
+- read_file: Read any file in the project
+- write_file: Write/create files
+- list_files: List files in directories
+- search_code: Search for code patterns
+- git_status: Check git status
+- scan_project: Understand project structure
+
+Instruction: {instruction}
+
+Think step by step:
+1. Understand what needs to be done
+2. Scan project structure if needed
+3. Read relevant files
+4. Plan the changes
+5. Make the changes
+6. Summarize what was done
+"""
+        
+        try:
+            result = self.agent.run(context)
+            
+            return {
+                "success": True,
+                "result": result,
+                "workspace": str(self.workspace)
+            }
+        except Exception as e:
+            return {
+                "success": False,
+                "error": str(e),
+                "workspace": str(self.workspace)
+            }
+    
+    def chat(self, message: str) -> str:
+        """
+        Chat with the agent while maintaining context.
+        
+        Args:
+            message: User message
+        
+        Returns:
+            Agent response
+        """
+        return self.agent.run(message)
+    
+    def reset_memory(self):
+        """Reset conversation memory"""
+        self.memory.clear()