Metadata-Version: 2.1
Name: varitykit
Version: 1.0.0
Summary: AI-powered CLI for building dashboards on Varity L3
Author-email: Varity Team <hello@varity.com>
License: MIT
Project-URL: Homepage, https://varity.ai
Project-URL: Documentation, https://docs.varity.ai/varitykit
Project-URL: Repository, https://github.com/varity-ai/varitykit-cli
Project-URL: Bug Tracker, https://github.com/varity-ai/varitykit-cli/issues
Keywords: varity,blockchain,depin,ai,dashboard,cli,web3
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Software Development :: Build Tools
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: click>=8.1.0
Requires-Dist: docker>=6.0.0
Requires-Dist: pyyaml>=6.0
Requires-Dist: requests>=2.31.0
Requires-Dist: rich>=13.0.0
Requires-Dist: toml>=0.10.2
Requires-Dist: jinja2>=3.1.0
Requires-Dist: python-dotenv>=1.0.0
Requires-Dist: aiohttp>=3.10.0
Requires-Dist: authlib>=1.3.0
Requires-Dist: ecdsa>=0.18.0
Requires-Dist: python-jose>=3.3.0
Requires-Dist: black>=24.3.0
Requires-Dist: copier>=9.0.0
Requires-Dist: pillow>=10.3.0
Requires-Dist: pynacl>=1.5.0
Requires-Dist: configobj>=5.0.8
Requires-Dist: fastapi>=0.109.1
Requires-Dist: filelock>=3.13.0
Requires-Dist: h2>=4.1.0
Requires-Dist: idna>=3.7
Requires-Dist: marshmallow>=3.21.0
Requires-Dist: python-multipart>=0.0.7
Requires-Dist: fonttools>=4.50.0
Provides-Extra: all
Requires-Dist: web3>=6.0.0; extra == "all"
Requires-Dist: eth-account>=0.10.0; extra == "all"
Requires-Dist: eth-utils>=2.3.0; extra == "all"
Requires-Dist: psutil>=5.9.0; extra == "all"
Provides-Extra: blockchain
Requires-Dist: web3>=6.0.0; extra == "blockchain"
Requires-Dist: eth-account>=0.10.0; extra == "blockchain"
Requires-Dist: eth-utils>=2.3.0; extra == "blockchain"
Provides-Extra: dev
Requires-Dist: pytest>=7.4.0; extra == "dev"
Requires-Dist: pytest-cov>=4.1.0; extra == "dev"
Requires-Dist: pytest-mock>=3.12.0; extra == "dev"
Requires-Dist: ruff>=0.1.0; extra == "dev"
Requires-Dist: mypy>=1.7.0; extra == "dev"
Requires-Dist: types-requests>=2.31.0; extra == "dev"
Requires-Dist: types-toml>=0.10.0; extra == "dev"
Requires-Dist: types-PyYAML>=6.0.0; extra == "dev"
Requires-Dist: types-click>=7.1.0; extra == "dev"
Requires-Dist: isort>=5.12.0; extra == "dev"
Requires-Dist: autoflake>=2.2.0; extra == "dev"

# VarityKit CLI

> AI-powered CLI for building dashboards on Varity L3

[![PyPI version](https://badge.fury.io/py/varitykit.svg)](https://badge.fury.io/py/varitykit)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
[![Python 3.10+](https://img.shields.io/badge/python-3.10+-blue.svg)](https://www.python.org/downloads/)

VarityKit is an enterprise-grade command-line tool for building, testing, and deploying AI-powered dashboard templates to the Varity L3 blockchain. Inspired by Algorand's AlgoKit, VarityKit enables developers worldwide to create industry-specific dashboards with built-in AI capabilities.

**Status:** ✅ **ALL BLOCKERS RESOLVED** - Ready for End-to-End Testing (Jan 24, 2026)

## Deployed Smart Contracts (Varity L3 - Chain ID 33529)

| Contract | Address | Purpose |
|----------|---------|---------|
| **TemplateMarketplace** | `0x769250dac29817081f38CfBa597Ef2485F3a94e8` | **70/30 Revenue Split** |
| **TemplateRegistry** | `0xEbD8C516c05BD2b76b5CDd56530b3Dd9f8b3D748` | Template metadata |
| **VarityAppRegistry** | `0x52d4f28ebe20fad743bbef9daa61bfe3ce91eb74` | App Store submissions |
| **SimplifiedPaymaster** | `0xeF467aef91d4e626C7e56967779069bEF22c4453` | Gas sponsorship |
| **VarityWalletFactory** | `0x85AB92708CB4d921f5c2BdCCd7f2D0813a380f71` | Smart wallets |

**Revenue Split:** 70% → Developer | 30% → Varity Platform

## 🎉 Enterprise-Grade Blockchain CLI - COMPLETE!

**VarityKit v1.0** - State-of-the-art multi-chain developer platform

### 🚀 What Makes VarityKit Unique

**The ONLY blockchain CLI with ALL of these:**
- ✅ **AI-Powered Code Generation** - Natural language to smart contracts
- ✅ **Multi-Industry Templates** - Finance, Healthcare, Retail, ISO
- ✅ **Multi-Chain Native** - Deploy to any EVM blockchain
- ✅ **Full Local DePin Stack** - 9 integrated services
- ✅ **Enterprise Features** - Matching AlgoKit + Hardhat + Foundry
- ✅ **State Management** - Snapshot/restore workflow states

### 📦 What's Included (77+ Commands)

**Phase 1 Complete** (Weeks 1-6):
- ✅ **Local Development Network** (`localnet`) - 8 commands
- ✅ **Deployment Automation** (`deploy`) - 4 commands
- ✅ **Contract Interaction** (`contract`) - 4 commands
- ✅ **Enhanced Doctor** - 20-29 comprehensive checks
- ✅ **Shell Completions** - Bash, zsh, fish
- ✅ **Task Utilities** - Wallet, storage, dashboard management
- ✅ **TestNet Dispenser** - Automated funding + faucet guide

**Phase 2 Complete** (Weeks 7-10):
- ✅ **Template Creation** (`template`) - 6 commands
- ✅ **AI-Powered Component Generation** - Natural language to code
- ✅ **Template Marketplace** (`marketplace`) - 6 commands
- ✅ **70/30 Revenue Sharing** - Automatic payments via smart contracts

See [docs/CLI_THIRDWEB_COMMANDS.md](docs/CLI_THIRDWEB_COMMANDS.md) for thirdweb integration details and blockchain command reference.

## Features

- **AI-Powered Configuration**: Intelligent project setup with chain-of-thought reasoning (Vertex AI / Gemini 2.5 Flash)
- **Conversational Interface**: Natural language Q&A instead of manual coding
- **Self-Correction**: Automatic code validation and error fixing (max 3 attempts)
- **Quality Scoring**: 6-dimension quality assessment with >85% threshold
- **Industry Templates**: Pre-built templates for Finance, Healthcare, Retail, ISO Merchant Services
- **DePin Integration**: Deploy to decentralized infrastructure (Akash, Filecoin, Celestia)
- **Local Development**: Full local blockchain environment with hot reload
- **Smart Contract Deployment**: Automated deployment to Varity L3 (testnet/mainnet)
- **RAG Knowledge Management**: 50,000+ knowledge documents for intelligent context
- **License Management**: Built-in revenue sharing and licensing system

## Installation

### Using pipx (Recommended)

```bash
# Standard installation
pipx install varitykit

# With blockchain utilities (wallet, fund commands)
pipx install "varitykit[blockchain]"

# With all optional features
pipx install "varitykit[all]"
```

### Using pip

```bash
# Standard installation
pip install varitykit

# With blockchain utilities (wallet, fund commands)
pip install "varitykit[blockchain]"

# With all optional features
pip install "varitykit[all]"
```

### Development Installation

```bash
# Clone repository
git clone https://github.com/varity-ai/varitykit-cli.git
cd varitykit-cli

# Install in editable mode with all features
pip install -e ".[all]"

# Install shell completions
varitykit completions --install
```

## Quick Start

### 1. Check Your Environment

```bash
varitykit doctor
```

This validates that all required tools are installed:
- Docker & Docker Compose
- Node.js & npm
- Python 3.10+
- Git

### 2. Create a New Project

```bash
varitykit init my-finance-dashboard
```

Follow the interactive prompts to configure your project:
- Select industry template (Finance, Healthcare, Retail, etc.)
- Configure company details
- Choose features and integrations

### 3. Install Dependencies

```bash
cd my-finance-dashboard
varitykit bootstrap
```

### 4. Start Development

```bash
# Start local DePin network
varitykit localdepin start

# Start development server
varitykit dev
```

Your dashboard will be available at http://localhost:3000

### 5. Deploy

```bash
# Deploy to testnet
varitykit deploy testnet

# Deploy to mainnet (requires license)
varitykit deploy mainnet
```

## Commands

### Core Commands

#### `varitykit doctor` ⭐ **ENHANCED (Phase 1)**

Comprehensive environment diagnostics with 20+ validation checks.

```bash
# Quick check (20 checks)
varitykit doctor

# Full diagnostics (29 checks - includes LocalDePin services)
varitykit doctor --full
```

**Check Categories**:
- Required Tools (6): Docker, Node.js, Python, Git
- System Resources (2): Disk space, Memory
- Project Configuration (2): .env file, varity.config.json
- Network Connectivity (1): Internet
- API Endpoints (2): Staging, Production
- Port Availability (3): 3000, 3001, 8545
- Blockchain RPC (3): Arbitrum L3, Sepolia, Arbitrum One
- LocalDePin Services (9, --full only): All 9 DePin services

#### `varitykit completions` ⭐ **NEW (Phase 1)**

Setup shell completions for bash, zsh, and fish.

```bash
# Auto-detect shell and show instructions
varitykit completions

# Auto-install to shell config
varitykit completions --install

# Generate for specific shell
varitykit completions --shell bash
```

Enables tab completion for all commands, options, and arguments.

#### `varitykit init [PROJECT_NAME]`

Initialize a new Varity dashboard project.

```bash
# Interactive mode
varitykit init

# With options
varitykit init my-dashboard --template finance --path ./projects/acme
```

Options:
- `--template, -t`: Template to use (finance, healthcare, retail, iso-merchant, generic)
- `--path, -p`: Path where project should be created
- `--yes, -y`: Skip confirmation prompts

#### `varitykit bootstrap`

Install project dependencies (npm, pip, Docker images).

```bash
varitykit bootstrap

# Skip specific steps
varitykit bootstrap --skip-npm --skip-docker
```

Options:
- `--skip-npm`: Skip npm install
- `--skip-pip`: Skip pip install
- `--skip-docker`: Skip Docker setup

### Local Development Network Commands ⭐ **NEW (Phase 1)**

#### `varitykit localnet`

Manage local DePin development network with 9 integrated services.

```bash
# Start entire local network (Arbitrum L3 + IPFS + Celestia + more)
varitykit localnet start

# Check status of all services
varitykit localnet status

# View logs (with optional filtering)
varitykit localnet logs
varitykit localnet logs -f                    # Follow logs
varitykit localnet logs -s arbitrum-node      # Specific service

# List pre-funded test accounts
varitykit localnet accounts                    # 10 accounts with 10K-1M ETH each

# Show network information
varitykit localnet info

# State management (save/restore network state)
varitykit localnet snapshot --name my-state
varitykit localnet restore --name my-state

# Stop network (preserves data)
varitykit localnet stop

# Reset to clean state (deletes all data)
varitykit localnet reset
```

**Included Services**:
- Arbitrum L3 Node (Chain ID: 421614)
- IPFS/Filecoin storage
- Celestia data availability
- PostgreSQL database
- Redis cache
- Pinata mock service
- Akash compute simulator
- Varity API server
- Block explorer (http://localhost:8080)

**Pre-funded Accounts**: 10 test accounts with 10,000-1,000,000 ETH each

**Unique Features**:
- State snapshots (save/restore workflow states)
- Integrated 9-service stack
- One-command startup (~60 seconds)

### Deployment Commands ⭐ **NEW (Phase 1)**

#### `varitykit deploy`

Enterprise-grade deployment automation with multi-network support.

```bash
# Deploy to local network
varitykit deploy run --network local

# Deploy to testnet with verification
varitykit deploy run --network sepolia --verify

# Interactive deployment wizard
varitykit deploy run --interactive

# Dry run (simulate without deploying)
varitykit deploy run --dry-run --network mainnet

# Check deployment status
varitykit deploy status

# View deployment history
varitykit deploy list

# Rollback to previous deployment
varitykit deploy rollback --network sepolia --steps 1
```

**Features**:
- Multi-network deployment (local/sepolia/mainnet)
- Automatic contract verification on Arbiscan
- Deployment state tracking
- Complete deployment history
- Rollback capabilities
- Interactive wizard mode
- Dry-run simulation
- Gas estimation

**Networks Supported**:
- `local` - LocalDePin network
- `sepolia` - Arbitrum Sepolia testnet
- `mainnet` - Arbitrum One mainnet

#### `varitykit app deploy` ⭐ **UPDATED (Jan 24, 2026)**

Deploy full applications to decentralized infrastructure with one command.

```bash
# Deploy static website to IPFS (default)
varitykit app deploy --hosting ipfs

# Deploy dynamic app to Akash (NEW!)
varitykit app deploy --hosting akash

# Deploy with custom resources
varitykit app deploy --hosting akash --cpu 2 --memory 2Gi --storage 5Gi

# Deploy specific directory
varitykit app deploy --path ./my-next-app

# Deploy to specific network
varitykit app deploy --network varity

# Submit to App Store
varitykit app deploy --submit-to-store

# Deploy and submit in one command
varitykit app deploy --hosting akash --submit-to-store

# List all deployments
varitykit app list

# View deployment details
varitykit app info deploy-1737492000

# Check deployment status
varitykit app status --network varity
```

**Hosting Options** ✅ COMPLETE:

| Option | Use Case | App Store Link |
|--------|----------|----------------|
| `--hosting ipfs` | Static websites | "Website" link |
| `--hosting akash` | Dynamic apps with compute | "Launch App" link |

**Features**:
- Frontend deployment to IPFS (static)
- Backend deployment to Akash (dynamic) - **NEW!**
- Automatic project detection (Next.js, React, Vue)
- Build automation
- thirdweb Storage integration
- Auto-submission to Varity App Store
- Cost: ~$0.01/GB/month (70-85% cheaper than AWS)

**Supported Frameworks**:
- Next.js 13+ (App Router with `output: "export"`)
- React 18+ (Create React App, Vite)
- Vue 3+
- Express.js, Fastify, FastAPI (Phase 2)

See [docs/APP_DEPLOY.md](docs/APP_DEPLOY.md) for complete documentation, examples, and troubleshooting.

### Development Commands

#### `varitykit dev`

Start development server with hot reload.

```bash
varitykit dev

# Custom ports
varitykit dev --frontend-port 3000 --backend-port 3001
```

#### `varitykit localdepin`

Manage local DePin network (Docker Compose).

```bash
# Start services
varitykit localdepin start

# Stop services
varitykit localdepin stop

# Reset to clean state
varitykit localdepin reset

# Show service status
varitykit localdepin status
```

#### `varitykit test`

Run tests.

```bash
# Run all tests
varitykit test

# Watch mode
varitykit test --watch

# Coverage report
varitykit test --coverage
```

### Deployment Commands

#### `varitykit deploy`

Deploy dashboard to blockchain network.

```bash
# Deploy to local network
varitykit deploy localnet

# Deploy to testnet
varitykit deploy testnet

# Deploy to mainnet
varitykit deploy mainnet
```

### Contract Interaction Commands ⭐ **NEW (Phase 1)**

#### `varitykit contract`

Interact with deployed smart contracts.

```bash
# Call read-only contract method
varitykit contract call 0x123... balanceOf 0xABC... --network sepolia

# Send state-changing transaction
varitykit contract send 0x123... transfer 0xABC... 1000000 --network sepolia

# Query historical events
varitykit contract events 0x123... --event Transfer --from-block 1000000 --network sepolia

# Watch events in real-time
varitykit contract events 0x123... --event Transfer --watch --network sepolia

# List deployed contracts
varitykit contract list --network sepolia
```

**Features**:
- Read-only contract method calls
- State-changing transactions with confirmation
- Event querying and real-time watching
- Automatic ABI loading from deployments
- Multi-network support (local/sepolia/mainnet)
- Transaction signing and receipt handling
- Gas estimation and custom limits

**Contract Call Options**:
- `--network` - Target network (local/sepolia/mainnet)
- `--abi` - Custom ABI file path
- `--value` - ETH to send with call (in wei)
- `--gas-limit` - Override gas limit

**Contract Send Options**:
- `--from-address` - Sender wallet address
- `--private-key` - Private key for signing
- `--confirm` - Skip confirmation prompt
- `--gas-limit` - Override gas limit
- `--value` - ETH to send with transaction

**Contract Events Options**:
- `--event` - Event name to filter (default: all events)
- `--from-block` - Start block number
- `--to-block` - End block number (default: latest)
- `--watch` - Real-time event watching
- `--limit` - Maximum events to display

### Template Creation Commands ⭐ **NEW (Phase 2A)**

#### `varitykit template`

Create, test, and manage dashboard templates with AI assistance.

```bash
# Create new template with AI-powered wizard
varitykit template create

# Create template for specific industry
varitykit template create --industry legal --name legal-dashboard

# Run automated tests
varitykit template test
varitykit template test --coverage           # With coverage report
varitykit template test --watch              # Watch mode

# Preview template in browser
varitykit template preview
varitykit template preview --port 3001       # Custom port

# Validate template quality
varitykit template validate
varitykit template validate --fix            # Auto-fix issues

# List available templates
varitykit template list

# Show template details
varitykit template info finance
```

**Features**:
- **AI-Powered Generation** - Natural language to production code in 10 minutes
- **Automated Component Creation** - 5-12 React components generated
- **TypeScript Support** - Full type safety with auto-generated types
- **Test Generation** - Unit tests + E2E tests (85%+ coverage)
- **Quality Validation** - 6-dimension quality scoring
- **Live Preview** - Hot reload development server
- **Production Ready** - Tailwind CSS, Vite, modern React

**Template Creation Flow**:
1. Describe industry and features (natural language)
2. AI generates React components automatically
3. Tests created (85%+ coverage)
4. Preview and validate
5. Ready to publish

**What You Provide**:
- Industry/vertical (e.g., legal, manufacturing, education)
- Main features (natural language description)
- Target company size (small/medium/large)
- Component preferences (optional)

**What AI Generates**:
- 5-12 React components (TypeScript)
- Dashboard pages with routing
- API integration code
- TypeScript types and interfaces
- Tailwind CSS styling
- Unit tests (85%+ coverage)
- E2E tests (Playwright)
- Documentation (README, API docs)

**Time Metrics**:
- Template creation: < 10 minutes
- Code you write: ~50 lines (config only)
- Code AI generates: ~2,000 lines

### Marketplace Commands ⭐ **NEW (Phase 2B)**

#### `varitykit marketplace`

Publish, discover, and monetize dashboard templates with 70/30 revenue sharing.

```bash
# Publish your template to marketplace
varitykit marketplace publish
varitykit marketplace publish --price 299

# Search for templates
varitykit marketplace search legal
varitykit marketplace search --category Finance --max-price 300

# Install template from marketplace
varitykit marketplace install legal-case-management
varitykit marketplace install healthcare-portal --output ./my-project

# View your statistics and earnings
varitykit marketplace stats

# Update published template
varitykit marketplace update --version 1.1.0
varitykit marketplace update --price 349

# Remove from marketplace
varitykit marketplace unpublish my-template
```

**Features**:
- **70/30 Revenue Split** - You keep 70% of every sale
- **Automatic Payments** - Via Varity L3 smart contracts
- **Template Discovery** - Search by category, price, quality
- **Quality Assurance** - Only 85+ quality score templates
- **Transparent Analytics** - Track downloads and earnings
- **Instant Installation** - One-command template purchase

**Publishing Requirements**:
- Quality score > 85/100
- Test coverage > 85%
- Complete documentation
- Valid template.json
- GitHub repository

**Revenue Model**:
- You set the price ($99-$999 recommended)
- Smart contract enforces 70/30 split
- Automatic payment on each sale
- No manual invoicing needed
- Transparent transaction history

**What Happens on Purchase**:
1. Customer pays template price
2. Smart contract splits payment:
   - 70% to template creator
   - 30% to Varity (platform fee)
3. Customer gets instant access
4. You receive payment automatically

**Example Earnings**:
```
Template Price: $299
Your Revenue: $209.30 per sale (70%)
Platform Fee: $89.70 (30%)

10 sales = $2,093
50 sales = $10,465
100 sales = $20,930
```

### Data Migration Commands ⭐ **NEW**

#### `varitykit migrate`

Migrate data from AWS S3 or Google Cloud Storage to Varity's decentralized infrastructure with blockchain verification.

```bash
# Migrate from AWS S3
varitykit migrate s3 --bucket my-s3-bucket --verify

# Migrate from Google Cloud Storage
varitykit migrate gcs --bucket my-gcs-bucket --project my-project

# Check migration status
varitykit migrate status --job-id mig_abc123xyz

# Verify migration integrity
varitykit migrate verify --job-id mig_abc123xyz

# Blockchain chain verification
varitykit migrate verify-chain --source-chain 1 --wallet 0xYourAddress

# Pre-flight checks
varitykit migrate preflight --source-chain 1 --wallet 0xYourAddress

# Generate migration report
varitykit migrate report --source-chain 1 --format markdown --output report.md

# List supported chains
varitykit migrate chains
```

**Features**:
- **Multi-Cloud Support** - Migrate from AWS S3 or Google Cloud Storage
- **Progress Tracking** - Real-time progress bars with speed indicators
- **Resume Capability** - Automatically resume interrupted migrations
- **Data Integrity** - SHA-256 hash verification for all transfers
- **Blockchain Verification** - Verify chain connectivity and compatibility
- **Contract Compatibility** - Check smart contract deployability
- **Cost Estimation** - Calculate savings vs. traditional cloud storage
- **Concurrent Transfers** - Configurable concurrency for optimal performance
- **Dry Run Mode** - Test migration without actual data transfer

**Supported Chains**:
- Ethereum Mainnet (1)
- Arbitrum One (42161)
- Arbitrum Sepolia (421614)
- Polygon (137)
- Base (8453)
- Optimism (10)
- Varity L3 Testnet (33529) - Default destination

**Migration Commands**:
- `s3` - Migrate from AWS S3 bucket
- `gcs` - Migrate from Google Cloud Storage bucket
- `status` - Check migration job status
- `verify` - Verify migration integrity
- `verify-chain` - Verify blockchain chain connectivity
- `preflight` - Run pre-flight checks before migration
- `chains` - List supported blockchain chains
- `report` - Generate comprehensive migration report

**Prerequisites**:
- Install @varity/migrate: `npm install -g @varity/migrate`
- AWS credentials (for S3 migrations)
- GCP credentials (for GCS migrations)
- Varity API credentials (VARITY_API_KEY)

### Utility Commands ⭐ **NEW (Phase 1)**

#### `varitykit task wallet`

Wallet management utilities.

```bash
# Create new wallet
varitykit task wallet create --name "Dev Wallet" --save

# Import existing wallet
varitykit task wallet import --name "Imported" --save

# List all wallets
varitykit task wallet list

# Check balance
varitykit task wallet balance --network sepolia
varitykit task wallet balance --address 0x123... --network local
```

#### `varitykit task storage`

IPFS/Filecoin storage utilities.

```bash
# Upload file to IPFS
varitykit task storage upload ./myfile.json --pin

# Download from IPFS
varitykit task storage download QmHash123... --output ./downloaded.json

# List pinned files
varitykit task storage list
```

#### `varitykit task dashboard`

Dashboard deployment and management utilities.

```bash
# Deploy dashboard
varitykit task dashboard deploy --name "Finance Dashboard" --network testnet

# List deployed dashboards
varitykit task dashboard list

# View dashboard logs
varitykit task dashboard logs <dashboard-id>
```

#### `varitykit fund` ⭐ **NEW (Phase 1)**

Fund wallet with test ETH from faucets.

```bash
# Fund default wallet on Sepolia (guided)
varitykit fund --network sepolia

# Fund specific address
varitykit fund --address 0x123... --network sepolia

# Fund on local network (automated)
varitykit fund --network local --amount 1.0
```

**Supported Faucets**:
- Alchemy Sepolia Faucet
- Chainlink Sepolia Faucet
- QuickNode Sepolia Faucet
- Infura Sepolia Faucet

Local network funding is fully automated. Sepolia funding provides guided instructions and browser integration.

### Advanced Commands

#### `varitykit configure`

Launch AI-powered configuration wizard.

```bash
varitykit configure
```

#### `varitykit knowledge`

Manage RAG knowledge base.

```bash
# Ingest documents
varitykit knowledge ingest ./docs

# Search knowledge
varitykit knowledge search "compliance requirements"

# Show statistics
varitykit knowledge stats

# Validate quality
varitykit knowledge validate
```

#### `varitykit license`

Manage dashboard licenses.

```bash
# Create license
varitykit license create

# Verify license
varitykit license verify <license-id>

# Show status
varitykit license status
```

#### `varitykit explore`

Launch VarityKit Explorer (web UI).

```bash
# Local explorer
varitykit explore

# Network-specific
varitykit explore testnet
varitykit explore mainnet
```

#### `varitykit generate`

Generate code from templates.

```bash
# Generate React component
varitykit generate component MyComponent

# Generate dashboard page
varitykit generate page Dashboard

# Generate API integration
varitykit generate api MyService
```

## Global Options

All commands support these global options:

- `--verbose, -v`: Enable verbose output
- `--debug`: Enable debug output
- `--json`: Output in JSON format
- `--version`: Show version
- `--help`: Show help

## Configuration

VarityKit uses `.varitykit.toml` for project configuration. This file is automatically created when you run `varitykit init`.

### Example Configuration

```toml
environment = "development"
project_name = "my-dashboard"
project_path = "/path/to/project"

[api]
staging_url = "https://staging.api.varity.io"
production_url = "https://api.varity.io"
local_url = "http://localhost:3001"
timeout = 30

[network]
localnet_rpc = "http://localhost:8545"
testnet_rpc = "https://sepolia.varity.io"
mainnet_rpc = "https://mainnet.varity.io"

[storage]
filecoin_gateway = "https://api.pinata.cloud"
ipfs_gateway = "https://gateway.pinata.cloud"

[logging]
level = "INFO"
json_format = false
```

## Environment Variables

- `VARITY_API_KEY`: API key for Varity services
- `VARITY_WALLET_ADDRESS`: Your Ethereum wallet address
- `VARITY_ENV`: Environment (development, staging, production)
- `VARITY_CONFIG_DIR`: Custom config directory

## Templates

VarityKit includes official templates for different industries:

### Finance Template
- Fraud detection
- AML monitoring
- Transaction analytics
- Compliance reporting

### Healthcare Template
- Patient management
- Appointment scheduling
- EHR integration
- HIPAA compliance

### Retail Template
- Inventory management
- Sales analytics
- Customer insights
- Supply chain tracking

### ISO Merchant Template
- Merchant onboarding
- Payment processing
- Residuals tracking
- PCI compliance

### Generic Template
- Data visualization
- Reporting
- User management

## Development

### Setup Development Environment

```bash
# Clone repository
git clone https://github.com/varity-ai/varitykit-cli.git
cd varitykit-cli

# Create virtual environment
python -m venv .venv
source .venv/bin/activate  # On Windows: .venv\Scripts\activate

# Install in editable mode
pip install -e ".[dev]"

# Run tests
pytest

# Run linting
black .
ruff check .
mypy varitykit
```

### Project Structure

```
varitykit-cli/
├── varitykit/
│   ├── cli/
│   │   ├── __init__.py
│   │   ├── main.py          # CLI entrypoint
│   │   ├── doctor.py        # doctor command
│   │   ├── init.py          # init command
│   │   ├── bootstrap.py     # bootstrap command
│   │   └── ...              # other commands
│   ├── core/
│   │   ├── __init__.py
│   │   ├── config.py        # Configuration management
│   │   └── templates.py     # Template management
│   ├── utils/
│   │   ├── __init__.py
│   │   ├── logger.py        # Logging utilities
│   │   └── validators.py    # Validation utilities
│   └── __init__.py
├── tests/
│   ├── unit/
│   ├── integration/
│   └── e2e/
├── docs/
├── examples/
├── pyproject.toml
├── README.md
└── LICENSE
```

## Contributing

We welcome contributions! Please see our [Contributing Guide](CONTRIBUTING.md) for details.

## License

MIT License - see [LICENSE](LICENSE) file for details.

## Support

- Documentation: https://docs.varity.ai/varitykit
- GitHub Issues: https://github.com/varity-ai/varitykit-cli/issues
- Discord: https://discord.gg/varity
- Email: hello@varity.com

## Related Projects

- [@varity/ui-kit](https://github.com/varity-ai/ui-kit) - React component library
- [@varity/core-backend](https://github.com/varity-ai/core-backend) - Backend services
- [varity-api-server](https://github.com/varity-ai/api-server) - API gateway

## Acknowledgments

Inspired by [AlgoKit](https://github.com/algorandfoundation/algokit-cli) from the Algorand Foundation.

---

Built with ❤️ by the Varity team
