Utilssets

A collection of development utilities and scripts for multi-platform environments.

Structure

utilssets/
├── bin/                    # Executable scripts and tools
├── lib/                    # Shared libraries
│   ├── shell/             # Shell function libraries
│   └── python/            # Python modules
├── config/                 # Configuration files
│   ├── shell/             # Shell configurations
│   ├── vim/               # Vim configurations
│   └── latex/             # LaTeX templates
├── tools/                  # Third-party tools
│   ├── pyenv/             # Python version manager
│   ├── fzf/               # Fuzzy finder
│   └── android-sdk/       # Android SDK tools
├── src/                    # Source code by language
│   ├── c/                 # C projects
│   ├── cpp/               # C++ projects
│   ├── python/            # Python projects
│   │   ├── audio/         # Audio processing
│   │   └── android/       # Android utilities
│   ├── cmake/             # CMake examples
│   └── gnu/               # GNU tools
├── scripts/                # Utility scripts by category
│   ├── android/           # Android development
│   ├── docker/            # Docker utilities
│   ├── git/               # Git utilities
│   ├── python/            # Python scripts
│   ├── tensorflow/        # TensorFlow utilities
│   └── system/            # System utilities
├── install/                # Installation scripts
│   ├── common/            # Common installers
│   ├── darwin/            # macOS-specific
│   └── linux/             # Linux-specific
├── docs/                   # Documentation
└── tests/                  # Test files

Quick Start

1. Initial Setup

# Run the installation wizard
bash install/common/setup_wizard.sh

2. Load Environment

Add to your ~/.bashrc or ~/.zshrc:

export UTILSSETS_ROOT="/path/to/utilssets"
source ${UTILSSETS_ROOT}/config/shell/config.env

3. Platform-Specific Setup

macOS:

bash install/darwin/wizard_Darwin.sh

Linux:

bash install/linux/wizard_Linux.sh

Components

Executables (bin/)

• System utilities and helper scripts
• Document conversion tools (md2pdf, tex2pdf)
• Android development tools
• Code formatting utilities

Libraries (lib/)

• Python: Machine learning utilities (PyTorch, ONNX), audio processing
• Shell: Common functions for error handling, logging, and utilities

Tools (tools/)

• pyenv: Python version management
• fzf: Fuzzy finder for command-line
• android-sdk: Android development tools

Scripts (scripts/)

• Android development automation
• Docker container management
• Git/Gerrit utilities
• System administration tools

Requirements

• Bash 4.0+ or Zsh 5.0+
• Git
• curl/wget
• Platform-specific: see install/common/prerequisite.sh

Configuration

Configuration files are located in config/:

• config/shell/env.conf: Environment variables
• config/shell/path.conf: PATH configurations
• config/shell/func.conf: Shell functions
• config/vim/: Vim configuration and plugins

Python Development

Install Python dependencies:

pip install -r requirements.txt

Import utilities:

from pyutils.ml import torch_model_utils, onnx_model_utils

Known Issues

See docs/issues.md for known issues and solutions.

Documentation

• Optimization History
• Restructure Plan

License

Internal use only.