nc1709 3.0.31
AI coding assistant with fine-tuned tool calling - Your code comes to life
Requires Python: >=3.9


# NC1709 - AI Coding Assistant

**99% Tool-Calling Accuracy** | Outperforms Claude Sonnet 3.5

---

## ⚡ INSTALLATION

```bash
# Install (Ubuntu/Debian/macOS):
pipx install nc1709

# Upgrade to latest version:
pipx upgrade nc1709

# Alternative install method:
pip install --user nc1709
```

> **Note:** On Ubuntu 23.04+, Debian 12+, use `pipx` (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