Getting Started in 10 Seconds

Install 260 zero-dependency CLI tools with one command. Here's everything you need to know.

On This Page

  1. Installation
  2. First Steps
  3. Shell Setup
  4. Real-World Workflows
  5. Tips & Tricks
  6. Next Steps

1 Installation

Quick Install (recommended)

Terminal
pip install evolver-tools
# or use the one-liner (no install needed):
curl -sL https://evolver-dev.github.io/evolver-tools/try.sh | bash

Requirements

Python 3.8+ is the only requirement. Every tool uses only Python standard library — zero external dependencies. Works on Linux, macOS, and Windows (including WSL).

No Install? No Problem

The try.sh script downloads a standalone binary. No Python required. Great for CI/CD, Docker containers, or air-gapped environments.

Verify Installation

Terminal
evtool version
evolver-tools v38.0.17 — 260 CLI tools

evtool welcome
╔══════════════════════════════════════╗
║    Welcome to evolver-tools!         ║
║    260 CLI tools, zero deps.         ║
╚══════════════════════════════════════╝

2 First Steps

Explore Available Tools

Terminal
evtool list
# Shows all 260 tools with descriptions, organized by category

evtool search csv
# Search for tools matching "csv" (fuzzy, case-insensitive)

evtool help csv-stats
# Show detailed help for a specific tool

Browse by Category

Tools are organized into 18 categories. Here are the most popular ones:

CategoryExample ToolsCount
CSV & Datacsv-stats, csv-chart, csv-select, csv-filter, csv-join, csv-sort32
JSON & YAMLjson-pretty, json-validate, json-merge, json-to-csv, yaml2json28
System & Monitorsysmon, cpu-stats, disk-usage, process-list, kill-port20
Networknet-analyzer, port-scan, dns-lookup, ssl-check, whois22
Security & Cryptopassgen, hash-file, hmac, otp, qrcode14
Text & Markdownb64, markmap, slugify, wordcount, regex-find25
File Managementren, find-dupes, split, checksum, file-type18
ASCII & Creativefiglet, cowsay, rainbow, progress-bar, emoji-cli16

3 Shell Setup

Alias for Faster Typing

Add these to your ~/.zshrc, ~/.bashrc, or ~/.config/fish/config.fish:

~/.zshrc
# evolver-tools shortcuts
alias ev=evtool          # Short alias
alias evl='evtool list'   # List tools
alias evs='evtool search' # Search tools

Auto-completion

evolver-tools ships with shell completion for bash, zsh, and fish:

Terminal
# Install completion (one-time)
eval "$(_EVTOOL_COMPLETE=zsh_source evtool)"  # zsh
eval "$(_EVTOOL_COMPLETE=bash_source evtool)" # bash

# Add to ~/.zshrc for persistence:
echo 'eval "$(_EVTOOL_COMPLETE=zsh_source evtool)"' >> ~/.zshrc
Tab Complete Everything

Once enabled, press Tab after evtool to see all 260 tool names. Type evtool csv- then Tab to filter CSV tools only.

4 Real-World Workflows

Workflow 1: Data Analysis Pipeline

Analyze a CSV file end-to-end — stats, visualization, and export — without opening a spreadsheet.

Terminal
# Step 1: Quick overview
evtool csv-stats sales.csv
# → Shows row count, columns, types, missing values, basic stats

# Step 2: Filter and transform
evtool csv-filter sales.csv --where "amount > 100" > big_deals.csv
evtool csv-select big_deals.csv --columns date,product,amount

# Step 3: Visualize
evtool csv-chart big_deals.csv --column amount --type histogram

# Step 4: Export
evtool csv-to-json big_deals.csv > big_deals.json

Workflow 2: System Health Check

Diagnose performance issues — CPU, memory, disk, network — from one terminal.

Terminal
# Real-time TUI monitor
evtool sysmon
# → Interactive TUI: CPU usage, memory, disk I/O, processes, network

# Quick one-liners
evtool disk-usage
evtool cpu-stats
evtool mem-info

# Find what's listening on port 8080
evtool kill-port 8080
# → Shows process and offers to kill it

Workflow 3: Network Debugging

Everything you need for network troubleshooting — from DNS to SSL.

Terminal
# Interactive network analyzer
evtool net-analyzer
# → TUI: ping, traceroute, DNS, ports, bandwidth

# Targeted checks
evtool dns-lookup example.com
evtool ssl-check example.com --days-left
evtool whois example.com

# Load test your API
evtool siege-lite https://api.example.com/health --concurrent 10 --requests 100
# → Latency percentiles, throughput, status codes

Workflow 4: Code Quality Audit

Scan a Python project for code smells — long functions, deep nesting, missing docs.

Terminal
# Full code smell scan
evtool smellfinder src/ --all
# → Long functions, too many params, deep nesting, missing docstrings

# Project health overview
evtool project-doctor
# → Checks README, license, .gitignore, setup.py, test files

Workflow 5: File Batch Operations

Rename, split, deduplicate, and checksum hundreds of files in seconds.

Terminal
# Batch rename (with dry-run preview)
evtool ren "*.jpg" --prefix "vacation_" --dry-run
# → Shows what would change, then apply with --go

# Split a large file
evtool split huge_log.csv --lines 1000 --prefix chunk_

# Find and remove duplicates (by content, not name)
evtool find-dupes ./photos/

# Checksum for verification
evtool checksum release.tar.gz --algorithm sha256

Workflow 6: Fun & Quick Utilities

Terminal
# Generate a strong password + QR code
evtool passgen 20 --symbols
evtool qrcode "https://example.com" > wifi.png

# Pomodoro timer
evtool pomodoro --work 25 --break 5

# Weather in your terminal
evtool weather-cli Shanghai

# Unit conversion
evtool unit-convert 42 km mi

# World clock
evtool world-clock Tokyo,London,Nairobi,New_York

5 Tips & Tricks

Chaining Tools

Pipe tools together: evtool csv-stats data.csv | evtool chart-cli — the output of one tool feeds into the next.

JSON Data Exploration

Quick-check any JSON: curl -s https://api.example.com/data | evtool json-pretty | head -50

Diff Two DNS Results

evtool dns-lookup site1.com > /tmp/a.txt && evtool dns-lookup site2.com > /tmp/b.txt && diff /tmp/a.txt /tmp/b.txt

Monitor a Directory in Real-Time

evtool watch ./logs/ --patterns "error,warning" — watch for file changes matching patterns.

Offline-First

All tools work completely offline (except network tools like dns-lookup and weather-cli). Install once, use anywhere — including air-gapped servers.

Windows Users

For the best experience, use Windows Terminal with WSL (Ubuntu) and a Nerd Font. The ASCII art, progress bars, and TUI tools render best with proper Unicode and ANSI support.

6 Next Steps

You're now ready to use evolver-tools. Here's where to go next:

Ready to use 260 tools?

One command, zero dependencies, infinite possibilities.

pip install evolver-tools

Or try it now: curl -sL https://evolver-dev.github.io/evolver-tools/try.sh | bash