smart-devenv 2.1.2

Production-grade CLI tool for automatic project environment setup, dependency installation, and DevOps automation

DevEnv

Automatic Development Environment Setup

DevEnv is an intelligent command-line interface (CLI) tool that automatically prepares development environments for software projects.

It detects the project language, installs required runtimes, installs dependencies, and prepares the project to run — all with a single command.

DevEnv helps eliminate the classic developer problem:

“It works on my machine.”

With DevEnv, developers can clone a repository and start coding in seconds without manually installing runtimes or dependencies.

---

Table of Contents

• Overview
• Features
• Installation
• Quick Start
• Supported Languages
• Commands
• CLI Usage
• Developer Workflow
• Cross Platform Support
• Why DevEnv
• Contributing
• License
• Author

---

Overview

Modern projects often require multiple runtimes, dependencies, and environment configurations. Setting these up manually can be slow and error-prone.

DevEnv solves this problem by automatically detecting project requirements and configuring the environment for you.

It supports multiple programming ecosystems and works across major operating systems.

DevEnv is designed for:

• Developers onboarding to new repositories
• Teams that want consistent development environments
• Open-source projects that want easier contributor setup

---

Features

One Command Setup

Prepare the entire development environment using a single command.

devenv setup

DevEnv automatically detects the project and installs everything required.

---

Smart Runtime Detection

DevEnv automatically detects required runtimes such as:

• Python
• Node.js
• Go

If a runtime is missing, DevEnv installs it automatically.

---

Automatic Dependency Installation

DevEnv detects dependency files and installs packages using the correct package manager.

Examples:

Language	Dependency File	Package Manager
Python	requirements.txt	pip
Python	pyproject.toml	pip / poetry
Node.js	package.json	npm
Go	go.mod	go

---

Intelligent Project Execution

DevEnv detects how a project should run and suggests the correct command.

Examples:

Framework	Command
Flask	flask run
FastAPI	uvicorn main:app
Node.js	npm start
Next.js	npm run dev

---

Cross Platform Support

DevEnv works on:

• Windows
• macOS
• Linux

It automatically handles OS-specific issues such as:

• executable permissions
• shell compatibility
• runtime installation differences

---

Installation

Install DevEnv from PyPI using pip.

pip install smart-devenv

Verify the installation.

devenv --version

---

Quick Start

Clone a project and configure the environment instantly.

git clone https://github.com/example/project.git
cd project

devenv setup

DevEnv will automatically:

1. Detect the project language
2. Check installed runtimes
3. Install missing runtimes
4. Install dependencies
5. Apply OS compatibility fixes
6. Suggest the correct run command

Your project will be ready to run.

---

Supported Languages

DevEnv currently supports automatic setup for:

• Python
• Node.js
• Go

Supported dependency files include:

requirements.txt
pyproject.toml
package.json
go.mod

More languages will be added in future releases.

---

Commands

DevEnv provides several commands to automate development environment setup.

---

devenv setup

The main command that prepares the entire development environment.

Usage

devenv setup [OPTIONS]

Options

Option	Description
-p, --path	Path to the project directory
-n, --dry-run	Show actions without executing them
-y, --yes	Skip confirmation prompts

Example

devenv setup

Setup a specific folder.

devenv setup --path ./backend

Preview actions without executing.

devenv setup --dry-run

---

devenv scan

Scans the project and detects language and dependency files.

Usage

devenv scan

Example output:

Detected Project

Language: Python
Dependency File: requirements.txt
Package Manager: pip

Scan a specific directory.

devenv scan --path ./services

---

devenv install

Installs project dependencies.

Usage

devenv install

Examples:

Python project

pip install -r requirements.txt

Node.js project

npm install

DevEnv automatically detects the correct package manager.

---

devenv run

Detects and runs the development server.

Usage

devenv run

Automatically run detected command.

devenv run --yes

Example detected commands:

Project Type	Run Command
Flask	flask run
FastAPI	uvicorn main:app
Node.js	npm start
Next.js	npm run dev

---

devenv doctor

Checks your system environment and verifies installed runtimes.

Usage

devenv doctor

Example output:

System Runtime Check

Python   Installed (3.11)
Node.js  Installed (20)
Go       Not Installed

This command helps ensure your machine is ready for development.

---

devenv info

Displays detailed information about the detected project.

Usage

devenv info

Example output:

Project Information

Language: Python
Package Manager: pip
Dependency File: requirements.txt
Python Version: 3.11

---

devenv summary

Displays a quick project overview.

Usage

devenv summary

Example output:

Project Summary

Language: Node.js
Dependency File: package.json
Dependencies: 52
Package Manager: npm

---

Typical Developer Workflow

Most developers will use DevEnv like this:

pip install devenv

git clone https://github.com/example/project.git
cd project

devenv setup
devenv run

Your development environment will be ready in seconds.

---

Why DevEnv

DevEnv solves common problems developers face when starting new projects.

Without DevEnv

• Install runtimes manually
• Install dependencies manually
• Fix OS compatibility issues
• Find correct run command

With DevEnv

devenv setup

Everything is configured automatically.

---

Contributing

Contributions are welcome.

If you would like to improve DevEnv:

1. Fork the repository
2. Create a feature branch
3. Commit your changes
4. Submit a pull request

Bug reports and feature requests are also appreciated.

---

License

This project is licensed under the MIT License.

---

Author

Aakash Birendra Singh

GitHub https://github.com/Aakashsingh0388

LinkedIn https://www.linkedin.com/in/aakash-singh-7b8416318