# Nemo Agent
[](https://pypi.org/project/nemo-agent/)
[](https://cdn.cometheart.com/nemo-agent.mp4)
## Nemo Agent is your Python AI Coder!
https://github.com/user-attachments/assets/51cf6ad1-196c-44ab-99ba-0035365f1bbd
## Features
* Runs blazing fast
* Generates Python project structures automatically using `uv`
* Writes Python code based on task descriptions
* Executes development tasks using AI-generated commands
* Utilizes the `mistral-nemo`, `OpenAI`, or `Claude` language models for intelligent code generation
* Ability to import reference documents to guide the task implementation
* Allows importing existing code projects in multiple languages to serve as a reference for the task
* Enables the importation of csv data files to populate databases or graphs
* Implements best practices in Python development automatically
* Writes and runs passing tests using `pytest` up to 80%+ test coverage
* Automatically fixes and styles code using `pylint` up to 7+/10
* Calculates and improves the complexity score using `complexipy` to be under 15
* Auto-formats the code with `autopep8`
* Shows the token count used for the responses
## Community
* Join our community - [Nemo Agent Telegram Group](https://t.me/+f-6nu2mUpgtiOGUx)
## Coding Ability
* `leetcode` hards
* `fastapi` or `flask` APIs
* `flask` web apps
* `streamlit` apps
* `tkinter` apps
* `jupyter notebook`
* Note: `OpenAI` > `Claude` > `mistral-nemo` for most coding projects
* Note: Not all runs will be successful with all models
## Install
### OpenAI or Claude Install
#### Requirements
* Python 3.9 or higher
* OpenAI or Claude API KEY
* Mac or Linux
#### Requirements Installation
* Install OpenAI or Claude API KEY for `zsh` shell
* `echo 'export OPENAI_API_KEY="YOUR_API_KEY"' >> ~/.zshrc` or
* `echo 'export ANTHROPIC_API_KEY="YOUR_API_KEY"' >> ~/.zshrc`
* `pip install nemo-agent`
* You are ready to use `nemo-agent`
### OR
### Mistral-Nemo Install
#### Requirements
* Python 3.9 or higher
* Ollama running `mistral-nemo`
* Linux with minimum specs of Ubuntu 24.04 with RTX 4070
#### Requirements Installation
* Ollama install instructions:
* `curl -fsSL https://ollama.com/install.sh | sh`
* `ollama pull mistral-nemo`
* `pip install nemo-agent`
* You are ready to use `nemo-agent`
## Usage
### Providers
* `ollama`: `nemo-agent --provider ollama`
* `openai`: `nemo-agent --provider openai`
* `claude`: `nemo-agent --provider claude`
### Import Reference Documentation Into Prompt
* Documentation files must be either: .md (Markdown) or .txt (Text) and be located in a folder
* `nemo-agent --docs example_folder`
### Import Existing Code Projects Into Prompt
* Code files must be either: .py (Python), .php (PHP), .rs (Rust), .js (JavaScript), .ts (TypeScript), .toml (TOML), .json (JSON), .rb (Ruby), or .yaml (YAML) and be located in a folder
* `nemo-agent --code example_folder`
### Import Data Into Prompt
* Data files must be .csv (CSV) and be located in a folder
* `nemo-agent --data example_folder`
### Prompting
#### CLI
* `nemo-agent "create a fizzbuzz script"`
#### OR
#### File Prompt
* Prompt file must be markdown (.md) or text files (.txt)
* `nemo-agent --file example.md` or
* `nemo-agent --file example.txt`
### Run Generated Program
* `cd generated_project_folder`
* `source .venv/bin/activate`
* `python main.py`
## Default Models
* `ollama` is `mistral-nemo` (default model)
* `openai` is `gpt-4o`
* `claude` is `claude-3-5-sonnet-20240620`
## Select Models
* `nemo-agent "my_prompt" --provider ollama --model nemotron`
## OpenAI o1 Support
* Supports `o1-mini` and `o1-preview`
* `nemo-agent "my prompt" --provider openai --model o1-mini`
## Contributing
Contributions to Nemo Agent are welcome! Please feel free to submit a Pull Request.
## License
This project is licensed under the MIT License - see the LICENSE file for details.
## Disclaimer
Nemo Agent generates code using an LLM. Every run is different as the LLM generated code is different. While it strives for accuracy and best practices, the generated code should be reviewed and tested before being used in a production environment.
Raw data
{
"_id": null,
"home_page": "https://nemo-agent.com",
"name": "nemo-agent",
"maintainer": null,
"docs_url": null,
"requires_python": "<4.0,>=3.9",
"maintainer_email": null,
"keywords": "ai, agent, ai agent, local ai agent, python ai agent",
"author": "Bevan Hunt",
"author_email": "bevan@bevanhunt.com",
"download_url": "https://files.pythonhosted.org/packages/bc/59/3b9387aafbc6f298724ac2dc776e7232f79d1708fc5279eccaa6a6bab656/nemo_agent-2.5.2.tar.gz",
"platform": null,
"description": "# Nemo Agent\n\n[](https://pypi.org/project/nemo-agent/)\n\n[](https://cdn.cometheart.com/nemo-agent.mp4)\n\n## Nemo Agent is your Python AI Coder!\n\n\nhttps://github.com/user-attachments/assets/51cf6ad1-196c-44ab-99ba-0035365f1bbd\n\n\n## Features\n* Runs blazing fast\n* Generates Python project structures automatically using `uv`\n* Writes Python code based on task descriptions\n* Executes development tasks using AI-generated commands\n* Utilizes the `mistral-nemo`, `OpenAI`, or `Claude` language models for intelligent code generation\n* Ability to import reference documents to guide the task implementation\n* Allows importing existing code projects in multiple languages to serve as a reference for the task\n* Enables the importation of csv data files to populate databases or graphs\n* Implements best practices in Python development automatically\n* Writes and runs passing tests using `pytest` up to 80%+ test coverage \n* Automatically fixes and styles code using `pylint` up to 7+/10\n* Calculates and improves the complexity score using `complexipy` to be under 15\n* Auto-formats the code with `autopep8`\n* Shows the token count used for the responses\n\n## Community\n* Join our community - [Nemo Agent Telegram Group](https://t.me/+f-6nu2mUpgtiOGUx)\n\n## Coding Ability\n* `leetcode` hards\n* `fastapi` or `flask` APIs\n* `flask` web apps\n* `streamlit` apps\n* `tkinter` apps\n* `jupyter notebook`\n* Note: `OpenAI` > `Claude` > `mistral-nemo` for most coding projects\n* Note: Not all runs will be successful with all models\n\n## Install \n\n### OpenAI or Claude Install\n\n#### Requirements\n* Python 3.9 or higher\n* OpenAI or Claude API KEY\n* Mac or Linux\n\n#### Requirements Installation\n* Install OpenAI or Claude API KEY for `zsh` shell\n * `echo 'export OPENAI_API_KEY=\"YOUR_API_KEY\"' >> ~/.zshrc` or\n * `echo 'export ANTHROPIC_API_KEY=\"YOUR_API_KEY\"' >> ~/.zshrc`\n* `pip install nemo-agent`\n* You are ready to use `nemo-agent`\n\n### OR\n\n### Mistral-Nemo Install\n\n#### Requirements\n* Python 3.9 or higher\n* Ollama running `mistral-nemo`\n* Linux with minimum specs of Ubuntu 24.04 with RTX 4070\n \n#### Requirements Installation\n* Ollama install instructions:\n * `curl -fsSL https://ollama.com/install.sh | sh`\n * `ollama pull mistral-nemo`\n* `pip install nemo-agent`\n* You are ready to use `nemo-agent`\n\n## Usage\n\n### Providers\n* `ollama`: `nemo-agent --provider ollama`\n* `openai`: `nemo-agent --provider openai`\n* `claude`: `nemo-agent --provider claude`\n\n### Import Reference Documentation Into Prompt\n* Documentation files must be either: .md (Markdown) or .txt (Text) and be located in a folder\n* `nemo-agent --docs example_folder`\n\n### Import Existing Code Projects Into Prompt\n* Code files must be either: .py (Python), .php (PHP), .rs (Rust), .js (JavaScript), .ts (TypeScript), .toml (TOML), .json (JSON), .rb (Ruby), or .yaml (YAML) and be located in a folder\n* `nemo-agent --code example_folder`\n\n### Import Data Into Prompt\n* Data files must be .csv (CSV) and be located in a folder\n* `nemo-agent --data example_folder`\n\n### Prompting\n\n#### CLI\n* `nemo-agent \"create a fizzbuzz script\"`\n\n#### OR\n\n#### File Prompt\n* Prompt file must be markdown (.md) or text files (.txt)\n* `nemo-agent --file example.md` or \n* `nemo-agent --file example.txt`\n\n### Run Generated Program\n* `cd generated_project_folder`\n* `source .venv/bin/activate`\n* `python main.py`\n\n## Default Models \n* `ollama` is `mistral-nemo` (default model)\n* `openai` is `gpt-4o`\n* `claude` is `claude-3-5-sonnet-20240620`\n\n## Select Models\n* `nemo-agent \"my_prompt\" --provider ollama --model nemotron`\n\n## OpenAI o1 Support\n* Supports `o1-mini` and `o1-preview`\n* `nemo-agent \"my prompt\" --provider openai --model o1-mini`\n\n## Contributing\nContributions to Nemo Agent are welcome! Please feel free to submit a Pull Request.\n\n## License\nThis project is licensed under the MIT License - see the LICENSE file for details.\n\n## Disclaimer\nNemo Agent generates code using an LLM. Every run is different as the LLM generated code is different. While it strives for accuracy and best practices, the generated code should be reviewed and tested before being used in a production environment.\n\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "Your Python AI Coder",
"version": "2.5.2",
"project_urls": {
"Homepage": "https://nemo-agent.com",
"Repository": "https://github.com/truemagic-coder/nemo-agent"
},
"split_keywords": [
"ai",
" agent",
" ai agent",
" local ai agent",
" python ai agent"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "8ff76bcc3ac98d4f5014242cc8c5345638c68338117170bff9200ac150fc326a",
"md5": "ea7ab86c79b0544e265b1583f993755d",
"sha256": "36c95820f274b2b232061400404105ea47d693aa4283c6caf002f3529d06bb6c"
},
"downloads": -1,
"filename": "nemo_agent-2.5.2-py3-none-any.whl",
"has_sig": false,
"md5_digest": "ea7ab86c79b0544e265b1583f993755d",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": "<4.0,>=3.9",
"size": 13419,
"upload_time": "2024-10-18T14:13:54",
"upload_time_iso_8601": "2024-10-18T14:13:54.830259Z",
"url": "https://files.pythonhosted.org/packages/8f/f7/6bcc3ac98d4f5014242cc8c5345638c68338117170bff9200ac150fc326a/nemo_agent-2.5.2-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "bc593b9387aafbc6f298724ac2dc776e7232f79d1708fc5279eccaa6a6bab656",
"md5": "082b8b86c86e5c16912572c1eded938c",
"sha256": "991a67b24bf1b5f5f3e2169a53c188afedc9d8384bea6ecb7bc23f18cf5313e5"
},
"downloads": -1,
"filename": "nemo_agent-2.5.2.tar.gz",
"has_sig": false,
"md5_digest": "082b8b86c86e5c16912572c1eded938c",
"packagetype": "sdist",
"python_version": "source",
"requires_python": "<4.0,>=3.9",
"size": 14140,
"upload_time": "2024-10-18T14:13:56",
"upload_time_iso_8601": "2024-10-18T14:13:56.449648Z",
"url": "https://files.pythonhosted.org/packages/bc/59/3b9387aafbc6f298724ac2dc776e7232f79d1708fc5279eccaa6a6bab656/nemo_agent-2.5.2.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-10-18 14:13:56",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "truemagic-coder",
"github_project": "nemo-agent",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "nemo-agent"
}
JSON
