Nemo Agent

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 OpenAI or Gemini 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
Run via UV (uvx)

Coding Ability

leetcode hards
fastapi or flask APIs
flask web apps
streamlit apps
tkinter apps
jupyter notebook

Install

Requirements

Python 3.10 or higher
OpenAI or Gemini API key
Mac or Linux
No GPU requirement

Requirements Installation

Install OpenAI or Gemini for zsh shell
- echo 'export OPENAI_API_KEY="YOUR_API_KEY"' >> ~/.zshrc or
- echo 'export GEMINI_API_KEY="YOUR_API_KEY"' >> ~/.zshrc
pip install uv
uvx nemo-agent - to run nemo-agent

Usage

Providers

openai: uvx nemo-agent (default)
gemini: uvx nemo-agent --provider gemini

Supported Models

openai is gpt-4.1 (default), o4-mini, and o3 (requires organization verification)
gemini is gemini-2.5-pro-preview-05-06(default) and gemini-2.5-flash-preview-05-20

Calling Non-Default Models

uvx nemo-agent --model o4-mini

Import Reference Documentation Into Prompt

Documentation files must be either: .md (Markdown) or .txt (Text) and be located in a folder
uvx 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
uvx nemo-agent --code example_folder

Import Data Into Prompt

Data files must be .csv (CSV) and be located in a folder
uvx nemo-agent --data example_folder

Prompting

CLI

uvx nemo-agent "create a fizzbuzz script"

OR

File Prompt

Prompt file must be markdown (.md) or text files (.txt)
uvx nemo-agent --file example.md or
uvx nemo-agent --file example.txt

Run Generated Program

cd generated_project_folder
source .venv/bin/activate
python main.py

Tests

Tests are automatically created and run.

Skipping Tests

You many want to skip tests especially if you are generating a UI application.

uvx nemo-agent "create a fizzbuzz script" --tests False

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.

Metadata

Release files for nemo-agent 5.0.3

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for nemo-agent 5.0.3
File	Size	Uploaded
nemo_agent-5.0.3.tar.gz	13.3 kB	May 21, 2025	Details

Built distribution (wheel)

Table of built distributions (wheels) for nemo-agent 5.0.3
File	Interpreter	ABI	Platform	Reset
nemo_agent-5.0.3-py3-none-any.whl 12.9 kB May 21, 2025	Python 3	none	any	Details

Total release size: 26.2 kB

Release files / nemo_agent-5.0.3.tar.gz

Download URL	nemo_agent-5.0.3.tar.gz
Size	13.3 kB
Tags	Source
SHA-256 checksum How to use checksums	`3bf231958a69fd8b4d90cc8a8900e5d40528b2ec6b8ec188b806671df0c470c6`
BLAKE2b-256 checksum How to use checksums	`4029ee4b6a444e8164e84b5d3684833291a9129a925bb6aa83c9c4b2df9c3ed4`
Upload date	May 21, 2025
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/6.1.0 CPython/3.9.22`

Release files / nemo_agent-5.0.3-py3-none-any.whl

Download URL	nemo_agent-5.0.3-py3-none-any.whl
Size	12.9 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`9d6b292a530765438ba44b0079a7a28d6f2ba06425bc5a4c4138e76e8b8b6f35`
BLAKE2b-256 checksum How to use checksums	`4172724c5188d72fa52aaf517f4bb681a550c0e59dfd5cbc8ca152839d986a62`
Upload date	May 21, 2025
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/6.1.0 CPython/3.9.22`