nutaan-cli


Namenutaan-cli JSON
Version 1.0.1 PyPI version JSON
download
home_pageNone
SummaryA powerful ReAct Python Assistant with AI capabilities
upload_time2025-08-03 17:50:25
maintainerNone
docs_urlNone
authorNone
requires_python>=3.8
licenseMIT
keywords ai assistant react python langchain openai claude
VCS
bugtrack_url
requirements langchain-openai langgraph langchain-core requests pydantic rich python-dotenv langchain-anthropic langchain-google-genai langchain-mistralai langchain-community langchain-cohere langchain-fireworks langchain-together langchain-groq
Travis-CI No Travis.
coveralls test coverage No coveralls.
            # Nutaan CLI - Your AI Developer Assistant in the Terminal ๐Ÿš€

[![Python](https://img.shields.io/badge/python-3.8%2B-blue.svg)](https://python.org)
[![License](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE)
[![Version](https://img.shields.io/badge/version-1.0.0-orange.svg)](https://github.com/Tecosys/nutaan-cli)

**Nutaan-CLI** is a powerful ReAct (Reasoning and Acting) Python assistant with AI capabilities, featuring Claude CLI-style tool displays, persistent task management, and professional terminal UI.

*Made by Tecosys*

## ๐ŸŽฅ Demo

![Nutaan CLI Demo](assets/nutaan-cli-demo.gif)

## โœจ Features

- ๐Ÿค– **AI-Powered Assistant** - Advanced reasoning with LangGraph and OpenAI
- ๐Ÿ“‹ **Plan Management** - Create, track, and complete tasks with strikethrough formatting
- ๐Ÿ”ง **Multiple Tools** - Web search, file operations, bash commands, and more
- ๐Ÿ’ญ **Think Mode** - Enhanced reasoning for complex problems
- ๐ŸŽจ **Rich Terminal UI** - Beautiful formatting with colors and progress tracking
- ๐Ÿ’พ **Persistent Storage** - Plans and session history automatically saved
- ๐Ÿš€ **Multiple Run Methods** - CLI command or Python module execution

## ๐Ÿ“ฆ Installation

### From PyPI (Recommended)
```bash
pip install nutaan-cli
```

### From Source (Development)
```bash
git clone https://github.com/Tecosys/nutaan-cli.git
cd nutaan-cli
pip install -e .
```

## ๐Ÿš€ Quick Start

### Basic Usage
```bash
# Interactive mode
nutaan

# Single prompt
nutaan "Hello, how can you help me?"

# Think mode for complex reasoning
nutaan --think "Analyze this complex problem"

# Show help
nutaan --help

# Check version
nutaan --version
```

### Python Module Execution
```bash
# All commands work with module execution too
python3 -m nutaan
python3 -m nutaan "Hello world"
python3 -m nutaan --think "Complex reasoning task"
```

## ๐Ÿ“‹ Plan Management

Nutaan-CLI includes a powerful plan tool for organizing and tracking tasks with visual progress indicators.

### Creating Plans
```bash
# Create a plan with multiple tasks
nutaan "Create a plan for building a website with tasks: Setup HTML, Add CSS, JavaScript functionality, Testing, Deployment"
```

**Output:**
```
โ€ข Website Project
Build a responsive website

  โ˜ Setup HTML structure
  โ˜ Add CSS styling  
  โ˜ JavaScript functionality
  โ˜ Testing across browsers
  โ˜ Deployment

Progress: 0/5 items completed (0.0%)
```

### Managing Tasks
```bash
# Complete a task (adds strikethrough)
nutaan "Complete the HTML setup task"

# Add new tasks
nutaan "Add a new task: Add responsive design"

# View all plans
nutaan "List all my plans"

# Show specific plan
nutaan "Show me the website project plan"
```

**Completed tasks show with strikethrough:**
```
โ€ข Website Project
Build a responsive website

  โ˜‘ Setup HTML structure        # โœ… Completed with strikethrough
  โ˜ Add CSS styling
  โ˜ JavaScript functionality
  โ˜ Testing across browsers
  โ˜ Deployment

Progress: 1/5 items completed (20.0%)
```

### Plan Tool Commands
```bash
# Direct plan tool usage
nutaan "Use plan tool to: create plan \"Project Name\" \"Description\" [\"Task 1\", \"Task 2\"]"
nutaan "Use plan tool to: complete item plan_id item_id"
nutaan "Use plan tool to: add item plan_id \"New task\""
nutaan "Use plan tool to: list plans"
```

## ๐Ÿ› ๏ธ Available Tools

### Core Tools
- **๐Ÿง  Think Tool** - Advanced reasoning and problem analysis
- **๐Ÿ“‹ Plan Tool** - Task management with progress tracking
- **๐Ÿ” Web Search** - Real-time information retrieval with Brave Search
- **๐Ÿ“ File Operations** - Read, write, and edit files with permission system
- **๐Ÿ’ป Bash Commands** - Execute system commands safely
- **โœ๏ธ File Editing** - Smart file editing with diff previews

### Tool Examples
```bash
# Web search
nutaan "Search for latest Python best practices"

# File operations
nutaan "Read the config.json file and explain its structure"
nutaan "Create a new Python script for data processing"

# System commands
nutaan "Check disk usage and system status"

# Complex reasoning
nutaan --think "Analyze the pros and cons of different deployment strategies"
```

## ๐Ÿ“Š Session Management

### History & Statistics
```bash
# View session history
nutaan --history

# Show usage statistics
nutaan --stats

# Resume previous conversation
nutaan "Resume our last conversation about the website project"
```

### Data Storage
- **Plans:** `.nutaan_data/plans.json` - All task plans and progress
- **Sessions:** Stored in memory during runtime
- **Configuration:** Automatic environment detection

## ๐ŸŽฏ Usage Examples

### Development Workflow
```bash
# 1. Create project plan
nutaan "Create a plan for building a Python web scraper with tasks: Setup environment, Design data model, Implement scraper, Add error handling, Write tests, Documentation"

# 2. Work through tasks
nutaan "Complete the environment setup task"
nutaan "Help me implement the data model for the scraper"

# 3. Track progress
nutaan "Show my scraper project progress"
```

### Learning & Research
```bash
# Complex analysis with think mode
nutaan --think "Explain the differences between async/await and threading in Python, with practical examples"

# Research with web search
nutaan "Find the latest best practices for FastAPI development"

# Create learning plan
nutaan "Create a learning plan for mastering React with tasks: JSX basics, Components, State management, Hooks, Routing, Testing"
```

### System Administration
```bash
# System monitoring
nutaan "Check system resources and suggest optimizations"

# File management
nutaan "Organize the Downloads folder by file type"

# Documentation
nutaan "Create documentation for this Python project based on the code structure"
```

## โš™๏ธ Configuration

### Using Nutaan API (Recommended)

For the best experience, use the official Nutaan API:

1. **Get API Key**: Visit [nutaan.com](https://nutaan.com) and create an API key in Settings
2. **Create Environment File**: Create a `.env` file with your configuration:

```bash
# LiteLLM Proxy Configuration
CUSTOM_API_KEY=nut-xxxxxxxxxxxxxxxx
CUSTOM_BASE_URL=https://api-prod.nutaan.com
CUSTOM_MODELS=nutaan

# Enable custom provider
PROVIDERS=custom
```

3. **Run with Environment**: Use the `-e` flag to specify your environment file:

```bash
nutaan -e .env "Your query here"
```

### Alternative: OpenAI API
```bash
# Optional: Custom API endpoints
export OPENAI_API_BASE="https://your-api-endpoint.com/"
export OPENAI_API_KEY="your-api-key"
```

### Command Line Options
```bash
nutaan --help                    # Show all options
nutaan --think                   # Enable think mode
nutaan --test                    # Run test queries
nutaan --history                 # Manage session history
nutaan --stats                   # Show usage statistics
nutaan --version                 # Show version info
```

## ๐ŸŽจ Rich Terminal UI

Nutaan-CLI provides a beautiful terminal experience with:

- **๐ŸŽจ Syntax highlighting** for code and diffs
- **๐Ÿ“Š Progress bars** for task completion
- **โœ… Strikethrough formatting** for completed tasks
- **๐Ÿ”ง Claude CLI-style** tool call displays
- **๐Ÿ“ฑ Responsive layout** that adapts to terminal size

## ๐Ÿ—๏ธ Architecture

### Package Structure
```
nutaan/
โ”œโ”€โ”€ __init__.py              # Package initialization
โ”œโ”€โ”€ __main__.py              # Module execution entry point
โ”œโ”€โ”€ cli.py                   # Command-line interface
โ”œโ”€โ”€ core/                    # Core functionality
โ”‚   โ”œโ”€โ”€ __init__.py
โ”‚   โ”œโ”€โ”€ agent_manager.py     # Agent creation and management
โ”‚   โ”œโ”€โ”€ session_history.py  # Session persistence
โ”‚   โ””โ”€โ”€ prompt_system.py    # System prompts and plan integration
โ””โ”€โ”€ tools/                   # Available tools
    โ”œโ”€โ”€ __init__.py
    โ”œโ”€โ”€ plan_tool.py         # Task management with Rich UI
    โ”œโ”€โ”€ brave_search_tool.py # Web search functionality
    โ”œโ”€โ”€ file_read_tool.py    # File reading operations
    โ”œโ”€โ”€ file_write_tool.py   # File writing with previews
    โ”œโ”€โ”€ file_edit_tool.py    # File editing with diffs
    โ”œโ”€โ”€ bash_run_tool.py     # System command execution
    โ””โ”€โ”€ think_tool.py        # Advanced reasoning
```

### Data Storage
```
.nutaan_data/
โ””โ”€โ”€ plans.json               # Persistent plan storage
```

### Technology Stack
- **LangGraph 0.6.2** - Agent orchestration and state management
- **LangChain** - LLM integration and tool management  
- **Rich 14.1.0** - Beautiful terminal UI with formatting
- **Pydantic** - Data validation and settings
- **OpenAI/Compatible APIs** - Language model inference

## ๐Ÿงช Development

### Setting Up Development Environment
```bash
# Clone repository
git clone https://github.com/Tecosys/nutaan-cli.git
cd nutaan-cli

# Install in development mode
pip install -e .

# Run tests
python -m pytest

# Run with development logging
nutaan --debug "Test message"
```

### Adding New Tools
1. Create tool class in `nutaan/tools/` following the pattern:
```python
from langchain.tools import BaseTool
from pydantic import Field

class MyCustomTool(BaseTool):
    name: str = "my_custom_tool"
    description: str = "Description of what the tool does"
    
    def _run(self, query: str) -> str:
        # Tool implementation
        return result
```

2. Add to `nutaan/tools/__init__.py`:
```python
from .my_custom_tool import MyCustomTool
__all__ = [..., "MyCustomTool"]
```

3. Import in `nutaan/core/agent_manager.py` and add to tools list

### Extending Plan Tool
The plan tool supports rich formatting and persistence:
```python
# Custom plan actions
plan_manager = PlanManager()
plan_id = plan_manager.create_plan("My Plan", "Description", ["Task 1", "Task 2"])
plan_manager.complete_item(plan_id, "item_1")
```

## ๐Ÿค Contributing

1. Fork the repository
2. Create a feature branch (`git checkout -b feature/amazing-feature`)
3. Commit your changes (`git commit -m 'Add amazing feature'`)
4. Push to the branch (`git push origin feature/amazing-feature`)
5. Open a Pull Request

### Development Guidelines
- Follow PEP 8 style guidelines
- Add type hints to all functions
- Write docstrings for public methods
- Add tests for new functionality
- Update documentation for new features

## ๐Ÿ› Troubleshooting

### Common Issues

#### Installation Problems
```bash
# If pip install fails, try upgrading pip
pip install --upgrade pip
pip install -e .
```

#### Missing API Keys
```bash
# Set OpenAI API key
export OPENAI_API_KEY="your-key-here"

# Verify configuration
nutaan "Test API connection"
```

#### Permission Errors
```bash
# Check file permissions
ls -la ~/.nutaan_data/

# Reset permissions if needed
chmod 755 ~/.nutaan_data/
chmod 644 ~/.nutaan_data/plans.json
```

### Debug Mode
```bash
# Enable debug logging
nutaan --debug "Your query here"

# View detailed error information
nutaan --verbose "Your query here"
```

## ๐Ÿ“„ License

This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.

## ๐Ÿ™ Acknowledgments

- Built with [LangChain](https://langchain.com/) and [LangGraph](https://langraph-doc.vercel.app/)
- UI powered by [Rich](https://rich.readthedocs.io/)
- Inspired by [Claude CLI](https://github.com/anthropics/claude-cli)
- Task management inspired by modern todo applications

## ๐Ÿ“ž Support

- ๐ŸŒ Visit: [tecosys.in](https://tecosys.in) | [nutaan.com](https://nutaan.com)
- ๐Ÿ“ง Email: info@tecosys.in
- ๐Ÿ› Issues: [GitHub Issues](https://github.com/Tecosys/nutaan-cli/issues)
- ๐Ÿ’ฌ Discussions: [GitHub Discussions](https://github.com/Tecosys/nutaan-cli/discussions)
- ๐Ÿ“– Documentation: [Wiki](https://github.com/Tecosys/nutaan-cli/wiki)

## ๐Ÿš€ Roadmap

### Upcoming Features
- ๐Ÿ“ฑ **Mobile companion app** - Control Nutaan from your phone
- ๐Ÿ”Œ **Plugin system** - Community-driven tool ecosystem
- ๐ŸŒ **Web interface** - Browser-based interaction
- ๐Ÿ“Š **Analytics dashboard** - Usage insights and productivity metrics
- ๐Ÿค **Team collaboration** - Shared plans and project management
- ๐Ÿ”„ **CI/CD integration** - Automated workflows and deployments

>[![Star History Chart](https://api.star-history.com/svg?repos=tecosys/nutaan-cli&type=Date)](https://star-history.com/#bytebase/star-history&Date)
---

**Made with โค๏ธ by Tecosys** | [Explore tecosys.in](https://tecosys.in) | [Visit nutaan.com](https://nutaan.com)

*Empowering developers with AI-assisted productivity*

            

Raw data

            {
    "_id": null,
    "home_page": null,
    "name": "nutaan-cli",
    "maintainer": null,
    "docs_url": null,
    "requires_python": ">=3.8",
    "maintainer_email": null,
    "keywords": "ai, assistant, react, python, langchain, openai, claude",
    "author": null,
    "author_email": "Tecosys <info@tecosys.in>",
    "download_url": "https://files.pythonhosted.org/packages/c0/a4/039ec67082f006efb4a14f298b2ba32dc602980bd0dee5cc2c0a2a99c38d/nutaan_cli-1.0.1.tar.gz",
    "platform": null,
    "description": "# Nutaan CLI - Your AI Developer Assistant in the Terminal \ud83d\ude80\n\n[![Python](https://img.shields.io/badge/python-3.8%2B-blue.svg)](https://python.org)\n[![License](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE)\n[![Version](https://img.shields.io/badge/version-1.0.0-orange.svg)](https://github.com/Tecosys/nutaan-cli)\n\n**Nutaan-CLI** is a powerful ReAct (Reasoning and Acting) Python assistant with AI capabilities, featuring Claude CLI-style tool displays, persistent task management, and professional terminal UI.\n\n*Made by Tecosys*\n\n## \ud83c\udfa5 Demo\n\n![Nutaan CLI Demo](assets/nutaan-cli-demo.gif)\n\n## \u2728 Features\n\n- \ud83e\udd16 **AI-Powered Assistant** - Advanced reasoning with LangGraph and OpenAI\n- \ud83d\udccb **Plan Management** - Create, track, and complete tasks with strikethrough formatting\n- \ud83d\udd27 **Multiple Tools** - Web search, file operations, bash commands, and more\n- \ud83d\udcad **Think Mode** - Enhanced reasoning for complex problems\n- \ud83c\udfa8 **Rich Terminal UI** - Beautiful formatting with colors and progress tracking\n- \ud83d\udcbe **Persistent Storage** - Plans and session history automatically saved\n- \ud83d\ude80 **Multiple Run Methods** - CLI command or Python module execution\n\n## \ud83d\udce6 Installation\n\n### From PyPI (Recommended)\n```bash\npip install nutaan-cli\n```\n\n### From Source (Development)\n```bash\ngit clone https://github.com/Tecosys/nutaan-cli.git\ncd nutaan-cli\npip install -e .\n```\n\n## \ud83d\ude80 Quick Start\n\n### Basic Usage\n```bash\n# Interactive mode\nnutaan\n\n# Single prompt\nnutaan \"Hello, how can you help me?\"\n\n# Think mode for complex reasoning\nnutaan --think \"Analyze this complex problem\"\n\n# Show help\nnutaan --help\n\n# Check version\nnutaan --version\n```\n\n### Python Module Execution\n```bash\n# All commands work with module execution too\npython3 -m nutaan\npython3 -m nutaan \"Hello world\"\npython3 -m nutaan --think \"Complex reasoning task\"\n```\n\n## \ud83d\udccb Plan Management\n\nNutaan-CLI includes a powerful plan tool for organizing and tracking tasks with visual progress indicators.\n\n### Creating Plans\n```bash\n# Create a plan with multiple tasks\nnutaan \"Create a plan for building a website with tasks: Setup HTML, Add CSS, JavaScript functionality, Testing, Deployment\"\n```\n\n**Output:**\n```\n\u2022 Website Project\nBuild a responsive website\n\n  \u2610 Setup HTML structure\n  \u2610 Add CSS styling  \n  \u2610 JavaScript functionality\n  \u2610 Testing across browsers\n  \u2610 Deployment\n\nProgress: 0/5 items completed (0.0%)\n```\n\n### Managing Tasks\n```bash\n# Complete a task (adds strikethrough)\nnutaan \"Complete the HTML setup task\"\n\n# Add new tasks\nnutaan \"Add a new task: Add responsive design\"\n\n# View all plans\nnutaan \"List all my plans\"\n\n# Show specific plan\nnutaan \"Show me the website project plan\"\n```\n\n**Completed tasks show with strikethrough:**\n```\n\u2022 Website Project\nBuild a responsive website\n\n  \u2611 Setup HTML structure        # \u2705 Completed with strikethrough\n  \u2610 Add CSS styling\n  \u2610 JavaScript functionality\n  \u2610 Testing across browsers\n  \u2610 Deployment\n\nProgress: 1/5 items completed (20.0%)\n```\n\n### Plan Tool Commands\n```bash\n# Direct plan tool usage\nnutaan \"Use plan tool to: create plan \\\"Project Name\\\" \\\"Description\\\" [\\\"Task 1\\\", \\\"Task 2\\\"]\"\nnutaan \"Use plan tool to: complete item plan_id item_id\"\nnutaan \"Use plan tool to: add item plan_id \\\"New task\\\"\"\nnutaan \"Use plan tool to: list plans\"\n```\n\n## \ud83d\udee0\ufe0f Available Tools\n\n### Core Tools\n- **\ud83e\udde0 Think Tool** - Advanced reasoning and problem analysis\n- **\ud83d\udccb Plan Tool** - Task management with progress tracking\n- **\ud83d\udd0d Web Search** - Real-time information retrieval with Brave Search\n- **\ud83d\udcc1 File Operations** - Read, write, and edit files with permission system\n- **\ud83d\udcbb Bash Commands** - Execute system commands safely\n- **\u270f\ufe0f File Editing** - Smart file editing with diff previews\n\n### Tool Examples\n```bash\n# Web search\nnutaan \"Search for latest Python best practices\"\n\n# File operations\nnutaan \"Read the config.json file and explain its structure\"\nnutaan \"Create a new Python script for data processing\"\n\n# System commands\nnutaan \"Check disk usage and system status\"\n\n# Complex reasoning\nnutaan --think \"Analyze the pros and cons of different deployment strategies\"\n```\n\n## \ud83d\udcca Session Management\n\n### History & Statistics\n```bash\n# View session history\nnutaan --history\n\n# Show usage statistics\nnutaan --stats\n\n# Resume previous conversation\nnutaan \"Resume our last conversation about the website project\"\n```\n\n### Data Storage\n- **Plans:** `.nutaan_data/plans.json` - All task plans and progress\n- **Sessions:** Stored in memory during runtime\n- **Configuration:** Automatic environment detection\n\n## \ud83c\udfaf Usage Examples\n\n### Development Workflow\n```bash\n# 1. Create project plan\nnutaan \"Create a plan for building a Python web scraper with tasks: Setup environment, Design data model, Implement scraper, Add error handling, Write tests, Documentation\"\n\n# 2. Work through tasks\nnutaan \"Complete the environment setup task\"\nnutaan \"Help me implement the data model for the scraper\"\n\n# 3. Track progress\nnutaan \"Show my scraper project progress\"\n```\n\n### Learning & Research\n```bash\n# Complex analysis with think mode\nnutaan --think \"Explain the differences between async/await and threading in Python, with practical examples\"\n\n# Research with web search\nnutaan \"Find the latest best practices for FastAPI development\"\n\n# Create learning plan\nnutaan \"Create a learning plan for mastering React with tasks: JSX basics, Components, State management, Hooks, Routing, Testing\"\n```\n\n### System Administration\n```bash\n# System monitoring\nnutaan \"Check system resources and suggest optimizations\"\n\n# File management\nnutaan \"Organize the Downloads folder by file type\"\n\n# Documentation\nnutaan \"Create documentation for this Python project based on the code structure\"\n```\n\n## \u2699\ufe0f Configuration\n\n### Using Nutaan API (Recommended)\n\nFor the best experience, use the official Nutaan API:\n\n1. **Get API Key**: Visit [nutaan.com](https://nutaan.com) and create an API key in Settings\n2. **Create Environment File**: Create a `.env` file with your configuration:\n\n```bash\n# LiteLLM Proxy Configuration\nCUSTOM_API_KEY=nut-xxxxxxxxxxxxxxxx\nCUSTOM_BASE_URL=https://api-prod.nutaan.com\nCUSTOM_MODELS=nutaan\n\n# Enable custom provider\nPROVIDERS=custom\n```\n\n3. **Run with Environment**: Use the `-e` flag to specify your environment file:\n\n```bash\nnutaan -e .env \"Your query here\"\n```\n\n### Alternative: OpenAI API\n```bash\n# Optional: Custom API endpoints\nexport OPENAI_API_BASE=\"https://your-api-endpoint.com/\"\nexport OPENAI_API_KEY=\"your-api-key\"\n```\n\n### Command Line Options\n```bash\nnutaan --help                    # Show all options\nnutaan --think                   # Enable think mode\nnutaan --test                    # Run test queries\nnutaan --history                 # Manage session history\nnutaan --stats                   # Show usage statistics\nnutaan --version                 # Show version info\n```\n\n## \ud83c\udfa8 Rich Terminal UI\n\nNutaan-CLI provides a beautiful terminal experience with:\n\n- **\ud83c\udfa8 Syntax highlighting** for code and diffs\n- **\ud83d\udcca Progress bars** for task completion\n- **\u2705 Strikethrough formatting** for completed tasks\n- **\ud83d\udd27 Claude CLI-style** tool call displays\n- **\ud83d\udcf1 Responsive layout** that adapts to terminal size\n\n## \ud83c\udfd7\ufe0f Architecture\n\n### Package Structure\n```\nnutaan/\n\u251c\u2500\u2500 __init__.py              # Package initialization\n\u251c\u2500\u2500 __main__.py              # Module execution entry point\n\u251c\u2500\u2500 cli.py                   # Command-line interface\n\u251c\u2500\u2500 core/                    # Core functionality\n\u2502   \u251c\u2500\u2500 __init__.py\n\u2502   \u251c\u2500\u2500 agent_manager.py     # Agent creation and management\n\u2502   \u251c\u2500\u2500 session_history.py  # Session persistence\n\u2502   \u2514\u2500\u2500 prompt_system.py    # System prompts and plan integration\n\u2514\u2500\u2500 tools/                   # Available tools\n    \u251c\u2500\u2500 __init__.py\n    \u251c\u2500\u2500 plan_tool.py         # Task management with Rich UI\n    \u251c\u2500\u2500 brave_search_tool.py # Web search functionality\n    \u251c\u2500\u2500 file_read_tool.py    # File reading operations\n    \u251c\u2500\u2500 file_write_tool.py   # File writing with previews\n    \u251c\u2500\u2500 file_edit_tool.py    # File editing with diffs\n    \u251c\u2500\u2500 bash_run_tool.py     # System command execution\n    \u2514\u2500\u2500 think_tool.py        # Advanced reasoning\n```\n\n### Data Storage\n```\n.nutaan_data/\n\u2514\u2500\u2500 plans.json               # Persistent plan storage\n```\n\n### Technology Stack\n- **LangGraph 0.6.2** - Agent orchestration and state management\n- **LangChain** - LLM integration and tool management  \n- **Rich 14.1.0** - Beautiful terminal UI with formatting\n- **Pydantic** - Data validation and settings\n- **OpenAI/Compatible APIs** - Language model inference\n\n## \ud83e\uddea Development\n\n### Setting Up Development Environment\n```bash\n# Clone repository\ngit clone https://github.com/Tecosys/nutaan-cli.git\ncd nutaan-cli\n\n# Install in development mode\npip install -e .\n\n# Run tests\npython -m pytest\n\n# Run with development logging\nnutaan --debug \"Test message\"\n```\n\n### Adding New Tools\n1. Create tool class in `nutaan/tools/` following the pattern:\n```python\nfrom langchain.tools import BaseTool\nfrom pydantic import Field\n\nclass MyCustomTool(BaseTool):\n    name: str = \"my_custom_tool\"\n    description: str = \"Description of what the tool does\"\n    \n    def _run(self, query: str) -> str:\n        # Tool implementation\n        return result\n```\n\n2. Add to `nutaan/tools/__init__.py`:\n```python\nfrom .my_custom_tool import MyCustomTool\n__all__ = [..., \"MyCustomTool\"]\n```\n\n3. Import in `nutaan/core/agent_manager.py` and add to tools list\n\n### Extending Plan Tool\nThe plan tool supports rich formatting and persistence:\n```python\n# Custom plan actions\nplan_manager = PlanManager()\nplan_id = plan_manager.create_plan(\"My Plan\", \"Description\", [\"Task 1\", \"Task 2\"])\nplan_manager.complete_item(plan_id, \"item_1\")\n```\n\n## \ud83e\udd1d Contributing\n\n1. Fork the repository\n2. Create a feature branch (`git checkout -b feature/amazing-feature`)\n3. Commit your changes (`git commit -m 'Add amazing feature'`)\n4. Push to the branch (`git push origin feature/amazing-feature`)\n5. Open a Pull Request\n\n### Development Guidelines\n- Follow PEP 8 style guidelines\n- Add type hints to all functions\n- Write docstrings for public methods\n- Add tests for new functionality\n- Update documentation for new features\n\n## \ud83d\udc1b Troubleshooting\n\n### Common Issues\n\n#### Installation Problems\n```bash\n# If pip install fails, try upgrading pip\npip install --upgrade pip\npip install -e .\n```\n\n#### Missing API Keys\n```bash\n# Set OpenAI API key\nexport OPENAI_API_KEY=\"your-key-here\"\n\n# Verify configuration\nnutaan \"Test API connection\"\n```\n\n#### Permission Errors\n```bash\n# Check file permissions\nls -la ~/.nutaan_data/\n\n# Reset permissions if needed\nchmod 755 ~/.nutaan_data/\nchmod 644 ~/.nutaan_data/plans.json\n```\n\n### Debug Mode\n```bash\n# Enable debug logging\nnutaan --debug \"Your query here\"\n\n# View detailed error information\nnutaan --verbose \"Your query here\"\n```\n\n## \ud83d\udcc4 License\n\nThis project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.\n\n## \ud83d\ude4f Acknowledgments\n\n- Built with [LangChain](https://langchain.com/) and [LangGraph](https://langraph-doc.vercel.app/)\n- UI powered by [Rich](https://rich.readthedocs.io/)\n- Inspired by [Claude CLI](https://github.com/anthropics/claude-cli)\n- Task management inspired by modern todo applications\n\n## \ud83d\udcde Support\n\n- \ud83c\udf10 Visit: [tecosys.in](https://tecosys.in) | [nutaan.com](https://nutaan.com)\n- \ud83d\udce7 Email: info@tecosys.in\n- \ud83d\udc1b Issues: [GitHub Issues](https://github.com/Tecosys/nutaan-cli/issues)\n- \ud83d\udcac Discussions: [GitHub Discussions](https://github.com/Tecosys/nutaan-cli/discussions)\n- \ud83d\udcd6 Documentation: [Wiki](https://github.com/Tecosys/nutaan-cli/wiki)\n\n## \ud83d\ude80 Roadmap\n\n### Upcoming Features\n- \ud83d\udcf1 **Mobile companion app** - Control Nutaan from your phone\n- \ud83d\udd0c **Plugin system** - Community-driven tool ecosystem\n- \ud83c\udf10 **Web interface** - Browser-based interaction\n- \ud83d\udcca **Analytics dashboard** - Usage insights and productivity metrics\n- \ud83e\udd1d **Team collaboration** - Shared plans and project management\n- \ud83d\udd04 **CI/CD integration** - Automated workflows and deployments\n\n>[![Star History Chart](https://api.star-history.com/svg?repos=tecosys/nutaan-cli&type=Date)](https://star-history.com/#bytebase/star-history&Date)\n---\n\n**Made with \u2764\ufe0f by Tecosys** | [Explore tecosys.in](https://tecosys.in) | [Visit nutaan.com](https://nutaan.com)\n\n*Empowering developers with AI-assisted productivity*\n",
    "bugtrack_url": null,
    "license": "MIT",
    "summary": "A powerful ReAct Python Assistant with AI capabilities",
    "version": "1.0.1",
    "project_urls": {
        "Bug Reports": "https://github.com/Tecosys/nutaan-cli/issues",
        "Documentation": "https://github.com/Tecosys/nutaan-cli/blob/main/README.md",
        "Homepage": "https://github.com/Tecosys/nutaan-cli",
        "Repository": "https://github.com/Tecosys/nutaan-cli"
    },
    "split_keywords": [
        "ai",
        " assistant",
        " react",
        " python",
        " langchain",
        " openai",
        " claude"
    ],
    "urls": [
        {
            "comment_text": null,
            "digests": {
                "blake2b_256": "2e64237128fc0fd6a30d7d9908d9e06209e7ce79ba6080942283be8ebb9d2feb",
                "md5": "e27c71ea66c843efc24693694faffbbe",
                "sha256": "caa90d832b5d2244812eb64bae1d6dd0b847dae385070031e58d8446494aa686"
            },
            "downloads": -1,
            "filename": "nutaan_cli-1.0.1-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "e27c71ea66c843efc24693694faffbbe",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": ">=3.8",
            "size": 53011,
            "upload_time": "2025-08-03T17:50:23",
            "upload_time_iso_8601": "2025-08-03T17:50:23.918745Z",
            "url": "https://files.pythonhosted.org/packages/2e/64/237128fc0fd6a30d7d9908d9e06209e7ce79ba6080942283be8ebb9d2feb/nutaan_cli-1.0.1-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": null,
            "digests": {
                "blake2b_256": "c0a4039ec67082f006efb4a14f298b2ba32dc602980bd0dee5cc2c0a2a99c38d",
                "md5": "14136b1bcfdd1dc9751282c587fc8245",
                "sha256": "0c5e57d502c8c37726732c7f197d5917aa6b4754378b358746f6fa8003f2519c"
            },
            "downloads": -1,
            "filename": "nutaan_cli-1.0.1.tar.gz",
            "has_sig": false,
            "md5_digest": "14136b1bcfdd1dc9751282c587fc8245",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": ">=3.8",
            "size": 49751,
            "upload_time": "2025-08-03T17:50:25",
            "upload_time_iso_8601": "2025-08-03T17:50:25.267728Z",
            "url": "https://files.pythonhosted.org/packages/c0/a4/039ec67082f006efb4a14f298b2ba32dc602980bd0dee5cc2c0a2a99c38d/nutaan_cli-1.0.1.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2025-08-03 17:50:25",
    "github": true,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "github_user": "Tecosys",
    "github_project": "nutaan-cli",
    "travis_ci": false,
    "coveralls": false,
    "github_actions": true,
    "requirements": [
        {
            "name": "langchain-openai",
            "specs": [
                [
                    ">=",
                    "0.2.0"
                ]
            ]
        },
        {
            "name": "langgraph",
            "specs": [
                [
                    ">=",
                    "0.5.0"
                ]
            ]
        },
        {
            "name": "langchain-core",
            "specs": [
                [
                    ">=",
                    "0.3.0"
                ]
            ]
        },
        {
            "name": "requests",
            "specs": [
                [
                    ">=",
                    "2.31.0"
                ]
            ]
        },
        {
            "name": "pydantic",
            "specs": [
                [
                    ">=",
                    "2.0.0"
                ]
            ]
        },
        {
            "name": "rich",
            "specs": [
                [
                    ">=",
                    "13.0.0"
                ]
            ]
        },
        {
            "name": "python-dotenv",
            "specs": [
                [
                    ">=",
                    "1.0.0"
                ]
            ]
        },
        {
            "name": "langchain-anthropic",
            "specs": [
                [
                    ">=",
                    "0.2.0"
                ]
            ]
        },
        {
            "name": "langchain-google-genai",
            "specs": [
                [
                    ">=",
                    "2.0.0"
                ]
            ]
        },
        {
            "name": "langchain-mistralai",
            "specs": [
                [
                    ">=",
                    "0.2.0"
                ]
            ]
        },
        {
            "name": "langchain-community",
            "specs": [
                [
                    ">=",
                    "0.3.0"
                ]
            ]
        },
        {
            "name": "langchain-cohere",
            "specs": [
                [
                    ">=",
                    "0.3.0"
                ]
            ]
        },
        {
            "name": "langchain-fireworks",
            "specs": [
                [
                    ">=",
                    "0.2.0"
                ]
            ]
        },
        {
            "name": "langchain-together",
            "specs": [
                [
                    ">=",
                    "0.2.0"
                ]
            ]
        },
        {
            "name": "langchain-groq",
            "specs": [
                [
                    ">=",
                    "0.2.0"
                ]
            ]
        }
    ],
    "lcname": "nutaan-cli"
}
        
Elapsed time: 2.28212s