sagellm-dev-tools: sageLLM Developer Tools

Status: 🚧 Under Development
PyPI Package: isagellm-dev-tools
CLI Tool: sagellm-dev

🎯 Purpose

Unified developer toolkit for sageLLM multi-repository development workflow.

📦 Installation

# Install from PyPI
pip install isagellm-dev-tools

# Or install from source
git clone git@github.com:intellistream/sagellm-dev-tools.git
cd sagellm-dev-tools
pip install -e .

Quickstart Script Modes

# standard: PyPI-first stable install (release/verification)
./quickstart.sh --standard

# dev: standard + local editable overlay (no duplicate dependency resolve)
./quickstart.sh --dev

# environment diagnostics
./quickstart.sh --doctor

Behavior summary:

• --standard: install isagellm-dev-tools from PyPI first.
• --dev: run standard install first, then apply local editable overlay via python3 -m pip install -e .[dev] --no-deps.
• Before install, quickstart dynamically uninstalls all installed isagellm-* packages to keep the environment re-runnable and clean.
• Script never creates venv/.venv; it reuses the current non-venv Python environment.

🚀 Quick Start

# Initialize development environment (clone all repos)
sagellm-dev init

# Sync all repositories
sagellm-dev sync

# Check architecture and dependencies
sagellm-dev check

# Install git hooks to all repos
sagellm-dev hooks install

# Push all repositories
sagellm-dev push

📖 Command Reference

Repository Management

sagellm-dev init                    # Clone all sageLLM repositories
sagellm-dev sync [--all]           # Sync all repos (git pull)
sagellm-dev push [--check]         # Batch push
sagellm-dev merge <from> <to>      # Batch merge branches
sagellm-dev status                 # Show status of all repos

Architecture & Dependency Checks

sagellm-dev check                  # Run all checks
sagellm-dev check --arch          # Architecture conformance
sagellm-dev check --chain         # Inference chain guard (no HF shortcut)
sagellm-dev check --deps          # Dependency versions
sagellm-dev check --hooks         # Git hooks integrity

Tool Fixes

sagellm-dev fix                   # Run all fixes
sagellm-dev fix --tools           # Fix tool versions (ruff, pre-commit)
sagellm-dev fix --deps            # Fix dependency mismatches

Git Hooks Management

sagellm-dev hooks install         # Install hooks to all repos
sagellm-dev hooks uninstall       # Remove hooks
sagellm-dev hooks update          # Update hook templates
sagellm-dev hooks status          # Check hooks status

PyTorch Management

sagellm-dev pytorch download <version> <platform>  # Download wheels
sagellm-dev pytorch upload <version> <platform>    # Upload to GitHub
sagellm-dev pytorch list                           # List versions

# Examples:
sagellm-dev pytorch download 2.5.1 cu121           # CUDA 12.1
sagellm-dev pytorch download 2.5.1 cpu             # CPU only

Information

sagellm-dev info                  # Show environment info
sagellm-dev version               # Show version

GitHub Issue Management

sagellm-dev gh list <repo>                                # List open issues
sagellm-dev gh view <repo> <issue>                        # View issue details
sagellm-dev gh assign <repo> <issue> <user>               # Assign issue to user
sagellm-dev gh assign-batch <repo> <user> <issues...>     # Batch assign
sagellm-dev gh priority <repo>                            # Group by assignee/priority
sagellm-dev gh stale [--days N] [--repos ...]             # Show stale issues (>N days)
sagellm-dev gh create <repo> --title "..."                # Create issue
		[--body "..."] [--assignee user]... [--label label]...

# Examples:
sagellm-dev gh create sagellm-website --title "[Feature] Leaderboard" \
	--body "负责人：王明琪" --assignee MingqiWang-coder --label enhancement

sagellm-dev gh stale                                      # All repos, >14 days
sagellm-dev gh stale --days 7                             # All repos, >7 days
sagellm-dev gh stale --repos sagellm-core --repos sagellm-kv-cache  # Specific repos

Statistics & Analytics

# Commit statistics
sagellm-dev stats commits [--since DATE] [--until DATE]   # Commit statistics
sagellm-dev stats commits --repos <repo1> --repos <repo2> # Specific repos
sagellm-dev stats commits --author <pattern>              # Filter by author
sagellm-dev stats commits --show-details                  # Show commit details
sagellm-dev stats commits --with-lines                    # Include line statistics

# Issue resolution statistics
sagellm-dev stats issues [--days N]                       # Closed issues (default: 30 days)
sagellm-dev stats issues --repos <repo1> --repos <repo2>  # Specific repos
sagellm-dev stats issues --show-details                   # Show detailed list

# Examples:
sagellm-dev stats commits                                 # All time, all repos
sagellm-dev stats commits --since "1 month ago"           # Last month
sagellm-dev stats commits --since 2024-01-01 --until 2024-12-31
sagellm-dev stats commits --author yang                   # Filter by author name
sagellm-dev stats commits --repos sagellm-core --show-details
sagellm-dev stats commits --with-lines                    # Show lines added/deleted
sagellm-dev stats issues                                  # Issues closed in last 30 days
sagellm-dev stats issues --days 7 --show-details          # Last week with details

sagellm-dev stats commits --since "1 week ago" --with-lines --show-details # Full report

## 🏗️ Architecture

sagellm-dev-tools/ ├── src/sagellm_dev_tools/ │ ├── cli.py # Main CLI entry │ ├── repo_manager.py # Repository operations │ ├── checker.py # Architecture/dependency checks │ ├── fixer.py # Automated fixes │ ├── hooks_manager.py # Git hooks management │ ├── pytorch_manager.py # PyTorch download/upload │ ├── constants.py # Constants │ └── templates/ # Git hook templates └── tests/

## 🔒 Privacy

This is a **private** repository. Internal use only for sageLLM development team.

## 📄 License

Proprietary - Internal Use Only

______________________________________________________________________

**Maintainer**: IntelliStream Team\
**Related**: [sagellm](https://github.com/intellistream/sagellm)