nc1709 1.16.0__tar.gz → 3.0.5__tar.gz

nc1709-3.0.5/PKG-INFO

@@ -0,0 +1,185 @@
+Metadata-Version: 2.4
+Name: nc1709
+Version: 3.0.5
+Summary: AI coding assistant with fine-tuned tool calling - Your code comes to life
+Home-page: https://github.com/lafzusa/nc1709
+Author: Lafzusa Corp
+Author-email: asif90988@gmail.com
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Topic :: Software Development :: Libraries :: Application Frameworks
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Classifier: License :: Other/Proprietary License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+Requires-Dist: rich>=13.0.0
+Requires-Dist: prompt_toolkit>=3.0.0
+Requires-Dist: click>=8.1.0
+Requires-Dist: pydantic>=2.0.0
+Requires-Dist: python-dotenv>=0.20.0
+Requires-Dist: httpx>=0.24.0
+Requires-Dist: aiofiles>=23.0.0
+Requires-Dist: psutil>=5.9.0
+Requires-Dist: ddgs>=9.0.0
+Provides-Extra: local
+Requires-Dist: litellm>=1.0.0; extra == "local"
+Requires-Dist: huggingface_hub>=0.20.0; extra == "local"
+Requires-Dist: transformers>=4.36.0; extra == "local"
+Requires-Dist: torch>=2.0.0; extra == "local"
+Requires-Dist: accelerate>=0.25.0; extra == "local"
+Requires-Dist: bitsandbytes>=0.41.0; extra == "local"
+Requires-Dist: peft>=0.7.0; extra == "local"
+Provides-Extra: server
+Requires-Dist: prometheus-client>=0.17.0; extra == "server"
+Requires-Dist: litellm>=1.0.0; extra == "server"
+Provides-Extra: memory
+Requires-Dist: chromadb>=0.4.0; extra == "memory"
+Requires-Dist: sentence-transformers>=2.2.0; extra == "memory"
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0.0; extra == "dev"
+Requires-Dist: pytest-asyncio>=0.21.0; extra == "dev"
+Requires-Dist: black>=23.0.0; extra == "dev"
+Requires-Dist: mypy>=1.0.0; extra == "dev"
+Provides-Extra: full
+Requires-Dist: litellm>=1.0.0; extra == "full"
+Requires-Dist: huggingface_hub>=0.20.0; extra == "full"
+Requires-Dist: transformers>=4.36.0; extra == "full"
+Requires-Dist: torch>=2.0.0; extra == "full"
+Requires-Dist: accelerate>=0.25.0; extra == "full"
+Requires-Dist: bitsandbytes>=0.41.0; extra == "full"
+Requires-Dist: peft>=0.7.0; extra == "full"
+Requires-Dist: prometheus-client>=0.17.0; extra == "full"
+Requires-Dist: chromadb>=0.4.0; extra == "full"
+Requires-Dist: sentence-transformers>=2.2.0; extra == "full"
+Dynamic: author
+Dynamic: author-email
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: home-page
+Dynamic: provides-extra
+Dynamic: requires-dist
+Dynamic: requires-python
+Dynamic: summary
+
+
+# NC1709 - AI Coding Assistant
+
+**99% Tool-Calling Accuracy** | Outperforms Claude Sonnet 3.5
+
+---
+
+## ⚡ INSTALLATION
+
+```bash
+# Recommended for Ubuntu/Debian/macOS:
+pipx install nc1709
+
+# Alternative:
+pip install --user nc1709
+```
+
+> **Important:** On Ubuntu 23.04+, Debian 12+, use `pipx install nc1709` (NOT `pip install nc1709`)
+
+## 🔑 SETUP API KEY
+
+```bash
+# Request your API key: asif90988@gmail.com
+export NC1709_API_KEY="your-api-key-here"
+
+# Add to ~/.bashrc for persistence:
+echo 'export NC1709_API_KEY="your-key"' >> ~/.bashrc
+```
+
+## 🚀 START USING
+
+```bash
+nc1709 "create a FastAPI server with authentication"
+```
+
+---
+
+## What Makes NC1709 Special
+
+- **99% Tool-Calling Accuracy**: Outperforms Claude Sonnet 3.5 (80.5%)
+- **Zero Setup Required**: No local models, no GPU needed
+- **Server-Side Intelligence**: Fine-tuned Qwen2.5-Coder-7B via API
+- **Enterprise Monitoring**: Prometheus metrics, health checks
+
+## Features
+
+- **File Operations**: Read, Write, Edit, Glob with 99% accuracy
+- **Code Search**: Advanced regex and context-aware search
+- **Git Integration**: Natural language git commands
+- **Bash Execution**: Safe command execution with smart permissions
+- **Web Tools**: Fetch and analyze web content
+- **Task Management**: Intelligent todo tracking
+
+## Quick Start
+
+```bash
+# Start coding with 99% accuracy AI
+nc1709
+
+# Example commands
+nc1709 "Find all Python functions with TODO comments"  
+nc1709 "Create a FastAPI endpoint for user auth"
+nc1709 "Debug the TypeError in main.py line 42"
+```
+
+## Why Choose NC1709?
+
+| Feature | NC1709 | Claude Sonnet 3.5 | Local Models |
+|---------|--------|--------------------|--------------|
+| **Tool Accuracy** | 99% | 80.5% | Variable |
+| **Setup Time** | 0 minutes | API key setup | Hours |
+| **Hardware Needed** | None | None | RTX 3090+ |
+| **Storage Required** | 0GB | 0GB | 15GB+ |
+
+## New in Version 3.0.0 - Unified Enhanced Architecture
+
+### 🏗️ Architecture Improvements
+- **Unified Codebase**: Single enhanced package replacing legacy dual-package structure
+- **5-Layer Cognitive System**: Router → Context → Council → Learning → Anticipation
+- **Dependency Injection**: Full IoC container with service locator pattern
+- **OpenTelemetry Tracing**: Distributed tracing with W3C context propagation
+- **Rate Limiting**: Token bucket algorithm with configurable strategies
+- **JSON Schema Validation**: Full draft-07 validation with type coercion
+- **Input Sanitization**: NC1709-SAN algorithm for command/path injection prevention
+- **API Key Masking**: NC1709-CAI (Color-Animal Identifier) for privacy
+
+### 🏭 Production-Ready Features
+- **Multi-Worker Scaling**: Automatic worker count optimization
+- **Connection Pooling**: Efficient resource management with retry logic
+- **Circuit Breaker**: Automatic failure detection and recovery
+- **Prometheus Metrics**: 15+ monitoring metrics for performance tracking
+- **Health Monitoring**: Comprehensive system health checks
+- **Load Balancing**: Nginx configuration with rate limiting
+- **Graceful Shutdown**: Clean resource cleanup on shutdown
+- **Auto-deployment**: One-command production deployment script
+
+### 📊 Monitoring Endpoints
+- `/health` - Basic health status
+- `/health/detailed` - Comprehensive system health
+- `/metrics` - Prometheus metrics endpoint
+- `/status/connections` - Connection pool statistics
+- `/status/circuit-breaker` - Circuit breaker status
+
+## Behind the Scenes
+
+**Our Training**: 800K examples on DeepFabric infrastructure  
+**Our Model**: Fine-tuned Qwen2.5-Coder-7B optimized for tool-calling  
+**Our Infrastructure**: Enterprise-grade servers with monitoring & auto-scaling
+**Your Benefit**: 99% accuracy with production-grade reliability
+
+## Links
+
+- Documentation: https://docs.lafzusa.com/nc1709
+- GitHub: https://github.com/lafzusa/nc1709
+- PyPI: https://pypi.org/project/nc1709/
+- Support: support@lafzusa.com

nc1709-3.0.5/README.md

@@ -0,0 +1,319 @@
+# NC1709 - 99% Accurate AI Coding Assistant
+
+[![PyPI version](https://img.shields.io/pypi/v/nc1709.svg)](https://pypi.org/project/nc1709/)
+[![Production Status](https://img.shields.io/badge/status-live-green.svg)](https://nc1709.lafzusa.com)
+[![Tool Accuracy](https://img.shields.io/badge/accuracy-99%25-brightgreen.svg)](https://pypi.org/project/nc1709/)
+
+> **Version 3.0.1** | Production-ready AI coding assistant with **99% tool-calling accuracy** and enterprise monitoring
+
+## 🏠 **WORKING DIRECTORY**
+```
+📁 /home/fas/special-1/extracted_nc1709/
+```
+**⚠️ All NC1709 production files are in this directory. This is your working directory for server management.**
+
+## 🚀 What Makes NC1709 Special
+
+- **99% Tool-Calling Accuracy**: Outperforms Claude Sonnet 3.5 (80.5%) on coding tasks
+- **Zero Setup Required**: No local models, no GPU needed, no configuration
+- **Instant Access**: Just `pip install nc1709` and start coding
+- **Server-Side Intelligence**: Access our fine-tuned Qwen2.5-Coder-7B via API
+- **Enterprise-Grade Performance**: Battle-tested on 800K training examples
+
+## Features
+
+| Tool | Description |
+|------|-------------|
+| **Read** | Read file contents with line number support |
+| **Write** | Create or overwrite files |
+| **Edit** | Precise string replacement in files |
+| **Glob** | Fast file pattern matching |
+| **Grep** | Content search with regex support |
+| **Bash** | Safe command execution |
+| **WebFetch** | Fetch and process web content |
+| **Task** | Spawn sub-agents for complex tasks |
+| **TodoWrite** | Task management and tracking |
+
+## Installation
+
+### One-Line Install (Recommended)
+```bash
+curl -fsSL https://nc1709.lafzusa.com/install.sh | bash
+```
+This automatically detects your system and uses the best installation method.
+
+### Alternative Methods
+
+**Using pipx (Ubuntu 23.04+, Debian 12+, modern Linux):**
+```bash
+# Install pipx first if needed
+sudo apt install pipx   # Debian/Ubuntu
+brew install pipx       # macOS
+
+# Then install nc1709
+pipx install nc1709
+```
+
+**Using pip with --user flag:**
+```bash
+pip install --user nc1709
+```
+
+**Using virtual environment:**
+```bash
+python3 -m venv ~/.nc1709-env
+~/.nc1709-env/bin/pip install nc1709
+echo 'export PATH="$HOME/.nc1709-env/bin:$PATH"' >> ~/.bashrc
+source ~/.bashrc
+```
+
+> **Note for Ubuntu 23.04+ / Debian 12+ users:** These systems use PEP 668 which prevents `pip install` without flags. Use `pipx install nc1709` or `pip install --user nc1709` instead.
+
+That's it! No local models to download, no GPU required.
+
+## 🚀 Quick Start for Users
+
+### Install
+```bash
+curl -fsSL https://nc1709.lafzusa.com/install.sh | bash
+```
+
+### Get API Key
+Email **asif90988@gmail.com** for your API key.
+
+### Use
+```bash
+export NC1709_API_KEY="your-api-key-here"
+nc1709 "create a FastAPI server with authentication"
+```
+
+### Test with Demo Key
+```bash
+export NC1709_API_KEY="nc1709_production_key"
+nc1709 "write a Python function to calculate factorial"
+```
+
+## Why Choose NC1709?
+
+| Feature | NC1709 | Claude Sonnet 3.5 | Local Models |
+|---------|--------|--------------------|--------------|
+| **Tool Accuracy** | 99% | 80.5% | Variable |
+| **Setup Time** | 0 minutes | API key setup | Hours |
+| **Hardware Needed** | None | None | RTX 3090+ |
+| **Storage Required** | 0GB | 0GB | 15GB+ |
+| **Cost** | Usage-based | API costs | Hardware costs |
+
+## How It Works
+
+NC1709 connects to our optimized server infrastructure:
+
+1. **Send Request** - Your command goes to our fine-tuned model
+2. **Smart Processing** - 7-layer cognitive architecture analyzes your task  
+3. **Tool Selection** - AI chooses the right tools with 99% accuracy
+4. **Execution** - Commands run on your local system securely
+5. **Results** - Get precise outputs faster than any local model
+
+## Behind the Scenes
+
+**Our Training**: 800K examples on DeepFabric infrastructure
+**Our Model**: Fine-tuned Qwen2.5-Coder-7B optimized for tool-calling  
+**Our Infrastructure**: Enterprise-grade servers for instant responses
+**Your Benefit**: 99% accuracy without any local setup
+
+## API Usage
+
+```python
+# Simple command execution
+import subprocess
+result = subprocess.run(['nc1709', 'help me debug this error'], capture_output=True, text=True)
+print(result.stdout)
+
+# Or use directly as CLI
+# nc1709 "refactor this function to be more efficient"
+```
+
+## Use Cases
+
+**Code Analysis**
+```bash
+nc1709 "Find all security vulnerabilities in my Django app"
+nc1709 "List all functions that need documentation"
+```
+
+**Code Generation**  
+```bash
+nc1709 "Create unit tests for the user authentication module"
+nc1709 "Generate a REST API client for this OpenAPI spec"
+```
+
+**Debugging & Fixes**
+```bash 
+nc1709 "Debug the memory leak in process.py"
+nc1709 "Optimize the database queries in this file"
+```
+
+**Project Management**
+```bash
+nc1709 "Create a requirements.txt from my imports"
+nc1709 "Set up GitHub Actions CI/CD for this Python project"
+```
+
+## 🌐 Production Status
+
+✅ **FULLY OPERATIONAL**
+- **Domain:** https://nc1709.lafzusa.com
+- **PyPI Package:** https://pypi.org/project/nc1709/2.1.7/
+- **Server:** Running on port 8000
+- **Model:** Custom Qwen2.5-Coder-7B via Ollama
+- **Test API Key:** `nc1709_production_key`
+
+## 🔧 Server Management (Production Team)
+
+### Working Directory
+```bash
+cd /home/fas/special-1/extracted_nc1709
+```
+
+### Quick Commands
+```bash
+# Start server
+source nc1709_production_env/bin/activate
+python production_server.py > server.log 2>&1 &
+
+# Check status
+curl https://nc1709.lafzusa.com/api/remote/status
+
+# View logs
+tail -f server.log
+
+# Stop server
+pkill -f "python production_server.py"
+```
+
+## 📚 Documentation
+
+| Guide | Purpose | Location |
+|-------|---------|----------|
+| **ARCHITECTURE.md** | System architecture & design patterns | [📄 View](./ARCHITECTURE.md) |
+| **DEPLOYMENT_GUIDE.md** | Production deployment with monitoring | [📄 View](./DEPLOYMENT_GUIDE.md) |
+| **SERVER_MANAGEMENT.md** | Admin commands & troubleshooting | [📄 View](./SERVER_MANAGEMENT.md) |
+| **PRODUCTION_SETUP.md** | Server deployment & management | [📄 View](./PRODUCTION_SETUP.md) |
+| **USER_GUIDE.md** | End-user documentation | [📄 View](./USER_GUIDE.md) |
+
+## 📧 Support & Contact
+
+- **Email:** asif90988@gmail.com
+- **API Key Requests:** Usually approved within 2-4 hours
+- **Technical Support:** Response within 24 hours
+- **Working Directory:** `/home/fas/special-1/extracted_nc1709/`
+
+## License
+
+Proprietary - Lafzusa Corp
+
+---
+
+## 🚀 **Ready to experience 99% accuracy?**
+
+```bash
+# Install NC1709 (one command)
+curl -fsSL https://nc1709.lafzusa.com/install.sh | bash
+
+# Email for API key: asif90988@gmail.com
+export NC1709_API_KEY="your-key"
+
+# Start building!
+nc1709 "let's create something amazing"
+```
+
+**NC1709** - Where your code comes to life with 99% accuracy! 🎯
+
+---
+
+**Production Directory:** `/home/fas/special-1/extracted_nc1709/`
+**Status:** ✅ Live and Operational
+**Last Updated:** January 14, 2026
+
+## Changelog
+
+### 3.0.4 (2026-01-15)
+- **🔐 API Key Instructions**: Clear messaging for first-time users about API key requirements
+- **📧 Contact Update**: Updated contact email to asif90988@gmail.com
+- **🚫 Early Auth Check**: App now checks for API key before attempting server connection
+- **📝 Better Error Messages**: Improved 401/403 error handling with setup instructions
+
+### 3.0.1 (2026-01-14)
+- **🚀 Universal Installer**: One-line install script that auto-detects OS and Python environment
+- **📦 PEP 668 Support**: Automatic handling of modern Linux externally-managed environments
+- **🔧 Smart Detection**: Automatically uses pipx, venv, or pip based on system configuration
+- **🎯 Flawless UX**: Users just run one curl command to install
+
+### 3.0.0 (2026-01-14)
+- **🏗️ Unified Codebase**: Merged nc1709_enhanced into single nc1709 package
+- **🧠 5-Layer Cognitive System**: Router → Context → Council → Learning → Anticipation
+- **💉 Dependency Injection**: Full IoC container with service locator pattern
+- **📡 OpenTelemetry Tracing**: Distributed tracing with W3C context propagation
+- **⏱️ Rate Limiting**: Token bucket algorithm with BLOCK/REJECT/DEGRADE strategies
+- **📋 JSON Schema Validation**: Full draft-07 validation with type coercion
+- **🛡️ Input Sanitization**: NC1709-SAN algorithm for command/path injection prevention
+- **🎭 API Key Masking**: NC1709-CAI (Color-Animal Identifier) for privacy
+- **📦 PEP 668 Compatible**: Updated installation docs for modern Linux systems
+- **🔒 Security Hardened**: Removed exposed credentials, added .gitignore
+
+### 2.2.0 (2026-01-09)
+- **🏭 Production Infrastructure**: Multi-worker scaling with Gunicorn UvicornWorker
+- **📊 Monitoring System**: Prometheus metrics with 15+ measurement points and Grafana dashboards
+- **🔗 Connection Pooling**: Async connection pooling with httpx for Ollama service
+- **💔 Circuit Breaker**: Three-state circuit breaker with automatic failure recovery
+- **🏥 Health Monitoring**: Enhanced health checks with detailed system status
+- **⚖️ Load Balancing**: Nginx configuration with rate limiting and upstream balancing
+- **🏗️ Architecture Refactor**: Agent class decomposed into 6 focused components (728 lines → modular)
+- **🎯 Strategy Pattern**: Pluggable LLM adapters for Ollama, OpenAI, and Azure
+- **🔌 Dependency Injection**: Full DI container with singleton, transient, and scoped lifetimes
+- **📤 Graceful Shutdown**: Phased shutdown handler with proper resource cleanup
+- **🔄 Async Patterns**: Complete async/await implementation throughout codebase
+- **🧪 Test Coverage**: Comprehensive test suite with 4 test files and extensive mocking
+- **🚀 Docker Deployment**: Multi-stage builds and container orchestration
+- **🚨 Exception System**: Custom exception hierarchy with proper error handling
+
+### 2.1.7 (2026-01-07)
+- **🌐 Production Server**: Custom Qwen2.5-Coder model via Ollama
+- **☁️ Domain Live**: https://nc1709.lafzusa.com fully operational  
+- **🔑 API Key System**: Working authentication with test key
+- **📡 Cloudflare Tunnel**: Secure connection infrastructure
+- **📦 PyPI Updated**: Latest version with production endpoints
+
+### 2.1.6 (2026-01-07)
+- **🔧 Entry Point Fix**: Corrected console script configuration
+- **📊 Version Display**: Fixed version number consistency
+- **🎯 Production Ready**: All systems tested and operational
+
+### 2.1.5 (2026-01-07)
+- **🚀 PyPI Release**: Initial production deployment
+- **🏗️ Architecture**: Server-side processing implementation
+
+### 2.1.4 (2025-01-05)
+- **🎉 Enhanced Welcome Screen**: Beautiful onboarding for new users
+- **📋 Demo Examples**: Shows what NC1709 can do before requiring API key
+- **📧 Clear Instructions**: Step-by-step guide for early access
+
+### 2.1.3 (2025-01-05)
+- **🔗 True Zero Setup**: Default server URL configured (nc1709.lafzusa.com)
+- **🚀 Instant Connection**: No environment variables needed
+- **✅ Auto-Remote Mode**: Always connects to server by default
+
+### 2.1.2 (2025-01-05)
+- **⚙️ Automatic PATH Setup**: CLI commands work immediately after install
+- **🛠️ Post-Install Fixes**: Shell integration and PATH detection
+
+### 2.1.0 (2025-01-05)
+- **🎯 99% Tool-Calling Accuracy**: Outperforms Claude Sonnet 3.5's 80.5%
+- **🚀 Zero Setup Experience**: No local models, just `pip install nc1709`
+- **⚡ Server-Side Intelligence**: Access fine-tuned Qwen2.5-Coder-7B via API
+- **📊 DeepFabric Training**: 800K examples for enterprise-grade performance
+- **🔧 Enhanced CLI**: New commands for training monitoring and benchmarking
+
+### 2.0.0 (2024-12-30)
+- Initial release with server-side processing
+- Core tool implementations
+- Basic CLI interface