{"id":14162389,"url":"https://github.com/datavorous/comandi","last_synced_at":"2025-09-03T15:44:42.890Z","repository":{"id":252761196,"uuid":"841353891","full_name":"datavorous/comandi","owner":"datavorous","description":"Effortless AI-Powered Command Line Tool for Seamless Programming, Intelligent Debugging, and Instant Command Execution.","archived":false,"fork":false,"pushed_at":"2024-08-26T08:35:09.000Z","size":7903,"stargazers_count":41,"open_issues_count":0,"forks_count":3,"subscribers_count":3,"default_branch":"main","last_synced_at":"2024-10-18T13:15:04.693Z","etag":null,"topics":["ai-assistant","artificial-intelligence","cli","cmd","command-line-tool","copilot","copilot-x","llama3-meta-ai","meta","python","python-3","python-library","python3","terminal","tui","wrapper"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/datavorous.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-08-12T08:37:26.000Z","updated_at":"2024-10-13T06:39:18.000Z","dependencies_parsed_at":"2024-08-26T10:28:16.349Z","dependency_job_id":"a409d281-04d6-4515-9356-950f89605519","html_url":"https://github.com/datavorous/comandi","commit_stats":{"total_commits":62,"total_committers":2,"mean_commits":31.0,"dds":"0.016129032258064502","last_synced_commit":"53d326c09b0ac51f412112418e42479696bf86b6"},"previous_names":["datavorous/comandi"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/datavorous%2Fcomandi","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/datavorous%2Fcomandi/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/datavorous%2Fcomandi/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/datavorous%2Fcomandi/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/datavorous","download_url":"https://codeload.github.com/datavorous/comandi/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248799904,"owners_count":21163400,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai-assistant","artificial-intelligence","cli","cmd","command-line-tool","copilot","copilot-x","llama3-meta-ai","meta","python","python-3","python-library","python3","terminal","tui","wrapper"],"created_at":"2024-08-17T13:00:42.433Z","updated_at":"2025-04-13T23:50:56.381Z","avatar_url":"https://github.com/datavorous.png","language":"Python","funding_links":[],"categories":["Terminal \u0026 CLI Agents"],"sub_categories":[],"readme":"### Closing Note\n\nThis was before AI agents were still not the hot topic. \nI was a Sublime Text user back then.\n\n---\n\n\u003cdiv align=\"center\"\u003e\n\n# comandi v0.0.2\n\nA Comprehensive AI-Powered Command-Line Interface for Programming Assistance,  \nError Debugging, and Command Translation.\n\n\u003ca href=\"https://app.commanddash.io/agent/github_datavorous_comandi\"\u003e\u003cimg src=\"https://img.shields.io/badge/AI-Code%20Agent-EB9FDA\"\u003e\u003c/a\u003e\n![Python version](https://img.shields.io/badge/python-3.10%2B-blue) \u003cbr\u003e\n\u003ca href=\"https://www.producthunt.com/posts/comandi?embed=true\u0026utm_source=badge-featured\u0026utm_medium=badge\u0026utm_souce=badge-comandi\" target=\"_blank\"\u003e\u003cimg src=\"https://api.producthunt.com/widgets/embed-image/v1/featured.svg?post_id=480995\u0026theme=light\" alt=\"Comandi - AI\u0026#0032;CLI\u0026#0032;Tool\u0026#0032;for\u0026#0032;Seamless\u0026#0032;Programming\u0026#0032;\u0026#0038;\u0026#0032;Smart\u0026#0032;Debugging | Product Hunt\" style=\"width: 250px; height: 54px;\" width=\"250\" height=\"54\" /\u003e\u003c/a\u003e\n\u003c/div\u003e\n\n## Demo\n\n\u003cdiv align=\"center\"\u003e \n\n\u003cimg src=\"https://raw.githubusercontent.com/datavorous/comandi/main/imgs/syntax.gif\" alt=\"demo\" width=\"93%\"\u003e  \n   \u003cbr\u003e\n\u003c/div\u003e\n\n## Overview\n\nCOMANDI is an AI-driven command-line tool designed to streamline programming workflows by translating natural language instructions into executable shell commands, debugging code, and offering targeted programming assistance. It leverages advanced natural language processing to enhance developer productivity directly from the terminal, using MetaAI(Llama3).\n\n## Features\n\n- **Command Translation:** Converts natural language commands into shell instructions, with the option to execute them directly.\n- **Code Analysis:** Supports understanding, debugging, and fixing code files. The tool provides summaries, debugging tips, and suggested code improvements.\n\n## Installation\n\nTo install COMANDI, ensure Python 3.10 or higher is installed, and follow these steps:\n\n1. **Clone the repository:**\n   ```bash\n   git clone https://github.com/datavorous/comandi.git\n   cd comandi\n   ```\n\n2. **Build the package:**\n   ```bash\n   pip install setuptools wheel\n   python setup.py sdist bdist_wheel\n   ```\n\n3. **Install the package:**\n   ```bash\n   pip install .\n   ```\n\n4. **Run COMANDI:**\n   ```bash\n   comandi -run\n   ```\n\n## Usage\n\nCOMANDI supports various functionalities tailored to enhance command-line operations and programming tasks:\n\n1. **Command Execution:**\n   - Input a natural language instruction.\n   - COMANDI translates it into a shell command, provides a description, and prompts for execution.\n\n2. **Code Analysis:**\n   - To analyze code, use:\n     ```bash\n     understand path/to/file.py\n     debug path/to/file.py\n     fix path/to/file.py\n     ```\n   - Specify line ranges for focused analysis:\n     ```bash\n     understand path/to/file.py:10-15,27-48\n     ```\n\n3. **System Information:**\n   - COMANDI displays key system details at startup, providing context for further operations.\n\n4. **Interactive Prompts:**\n   - Engage with the AI to receive hints, command suggestions, and code fixes. Example:\n     ```bash\n     :: How do I sort a list in Python?\n     ```\n\n## Technical Overview\n\n- **Programming Language:** Python 3.10+\n- **Core Libraries:**\n  - `rich`: Provides enhanced terminal formatting.\n  - `subprocess`: Facilitates command execution.\n  - `pkg_resources`: Manages resource paths and dependencies.\n  - `MetaAI`: Powers AI-driven features.\n\n## Roadmap\n\n- **User Preferences:** Customizable settings for user-specific preferences.\n- **Command History:** Save and recall previous commands.\n- **Version Control Integration:** Git and other VCS operations from the CLI.\n\n## Contribution\n\nContributions are welcome. Please refer to the [CONTRIBUTING.md](CONTRIBUTING.md) file for guidelines.\n\n## License\n\nThis project is licensed under the Apache License 2.0. See the [LICENSE](LICENSE) file for details.\n\n## Acknowledgments\n\nSpecial thanks to the creators of the `MetaAI` and `rich` libraries for their invaluable tools.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdatavorous%2Fcomandi","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdatavorous%2Fcomandi","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdatavorous%2Fcomandi/lists"}