Skip to content

Commit 514b6c8

Browse files
committed
chore(release): update package version to 0.11.0
1 parent 326df9d commit 514b6c8

File tree

3 files changed

+103
-3
lines changed

3 files changed

+103
-3
lines changed

CHANGELOG.md

Lines changed: 100 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -2,6 +2,106 @@
22

33
All notable changes to LocalLab will be documented in this file.
44

5+
## [0.11.0] - 2025-07-08
6+
7+
### 🎉 Major Release - Comprehensive Model Management CLI
8+
9+
This release introduces a powerful model management system that allows users to discover, download, organize, and manage AI models locally. The new `locallab models` command group provides comprehensive model management capabilities with HuggingFace Hub integration.
10+
11+
### Added
12+
13+
#### 🤖 Complete Model Management CLI
14+
- **New `locallab models` command group** - Comprehensive model management functionality
15+
- **Model discovery** - Search and discover models from LocalLab registry and HuggingFace Hub
16+
- **Local model download** - Download models locally for faster startup and offline usage
17+
- **Model listing** - List all locally cached models with detailed information
18+
- **Model removal** - Remove cached models to free up disk space
19+
- **Model information** - Get detailed information about any model including system compatibility
20+
- **Cache cleanup** - Clean up orphaned cache files and free disk space
21+
22+
#### 🔍 Advanced Model Discovery
23+
- **HuggingFace Hub integration** - Real-time search of HuggingFace Hub models
24+
- **Smart filtering** - Automatic filtering for text-generation models suitable for LocalLab
25+
- **Search functionality** - Search models by keywords, tags, or descriptions
26+
- **Tag filtering** - Filter models by categories (e.g., "conversational", "chat")
27+
- **Popularity metrics** - Display download counts and popularity information
28+
- **Sort options** - Sort by downloads, likes, or recent updates
29+
30+
#### 🛠️ Model Management Features
31+
- **Offline capability** - Registry models always available without internet
32+
- **Cache management** - Intelligent model cache with metadata tracking
33+
- **System compatibility** - Check if models work on your hardware before downloading
34+
- **Progress indicators** - Beautiful progress bars for download operations
35+
- **Error handling** - Robust error handling with graceful fallbacks
36+
- **Multiple output formats** - Table and JSON output for both human and programmatic use
37+
38+
#### 📊 Enhanced User Experience
39+
- **Rich UI components** - Beautiful tables and progress indicators using Rich library
40+
- **Clear feedback** - Informative messages and status indicators
41+
- **Graceful degradation** - Works perfectly with or without internet connection
42+
- **Rate limiting** - Respectful API usage with built-in rate limiting
43+
- **Network timeouts** - Proper timeout handling for network operations
44+
45+
### Enhanced
46+
47+
#### 🚀 Model Management Infrastructure
48+
- **New cache manager** - `locallab/utils/model_cache.py` for centralized cache management
49+
- **HuggingFace searcher** - `locallab/utils/huggingface_search.py` for Hub integration
50+
- **Model metadata tracking** - Track download dates, access counts, and model information
51+
- **Improved model loading** - Better integration with existing model loading system
52+
53+
#### 📖 Documentation Expansion
54+
- **Comprehensive model management guide** - Complete documentation with examples and troubleshooting
55+
- **Updated CLI documentation** - Enhanced CLI reference with model management commands
56+
- **Getting started improvements** - Added model management to onboarding flow
57+
- **Cross-references** - Proper linking between all model management documentation
58+
59+
### Commands Added
60+
61+
#### 🎯 New CLI Commands
62+
```bash
63+
locallab models list # List locally cached models
64+
locallab models download <id> # Download a model locally
65+
locallab models remove <id> # Remove a cached model
66+
locallab models discover # Discover available models
67+
locallab models info <id> # Show detailed model information
68+
locallab models clean # Clean up orphaned cache files
69+
```
70+
71+
#### 🔧 Command Options
72+
- **Discovery options**: `--search`, `--tags`, `--sort`, `--registry-only`, `--hub-only`
73+
- **Output formats**: `--format table|json` for all commands
74+
- **Filtering options**: `--registry-only`, `--custom-only` for listing
75+
- **Safety options**: `--force` for downloads and removals
76+
77+
### Technical Improvements
78+
79+
#### 🏗️ Architecture Enhancements
80+
- **Modular design** - Clean separation of concerns with dedicated modules
81+
- **API integration** - Proper HuggingFace Hub API integration with error handling
82+
- **Cache optimization** - Efficient model cache management and cleanup
83+
- **Memory management** - Proper cleanup of model resources after operations
84+
85+
#### 🛡️ Reliability Features
86+
- **Network resilience** - Graceful handling of network issues and timeouts
87+
- **Error recovery** - Comprehensive error handling with helpful user messages
88+
- **Data validation** - Proper validation of model information and cache data
89+
- **Backward compatibility** - Full compatibility with existing LocalLab functionality
90+
91+
### Benefits for Users
92+
93+
#### ⚡ Performance Improvements
94+
- **Faster server startup** - Pre-downloaded models load instantly
95+
- **Offline usage** - Use models without internet connection after download
96+
- **Disk space management** - Easy cleanup and monitoring of model cache
97+
- **Better resource utilization** - Smart model selection based on system capabilities
98+
99+
#### 🎯 User Experience
100+
- **Model discovery** - Easily find new models from HuggingFace Hub
101+
- **Informed decisions** - See popularity metrics and system requirements before downloading
102+
- **Simple management** - Easy-to-use commands for all model operations
103+
- **Clear feedback** - Always know what's happening with clear status messages
104+
5105
## [0.10.0] - 2025-07-06
6106

7107
### 🎉 Major Release - Enhanced Chat Interface & Documentation Overhaul

locallab/__init__.py

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,7 @@
66
# This ensures Hugging Face's progress bars are displayed correctly
77
from .utils.early_config import configure_hf_logging
88

9-
__version__ = "0.10.0" # Enhanced chat interface with dynamic mode switching and comprehensive documentation overhaul
9+
__version__ = "0.11.0" # Comprehensive model management CLI with HuggingFace Hub integration
1010

1111
# Only import what's necessary initially, lazy-load the rest
1212
from .logger import get_logger

setup.py

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -25,7 +25,7 @@
2525
"psutil>=5.8.0",
2626
"nest-asyncio>=1.5.1",
2727
"fastapi-cache2>=0.2.1",
28-
"huggingface_hub>=0.16.0",
28+
"huggingface_hub>=0.20.0",
2929
"typing_extensions>=4.0.0",
3030
"questionary>=1.10.0",
3131
]
@@ -47,7 +47,7 @@
4747

4848
setup(
4949
name="locallab",
50-
version="0.10.0",
50+
version="0.11.0",
5151
packages=find_packages(include=["locallab", "locallab.*"]),
5252
install_requires=install_requires,
5353
extras_require={

0 commit comments

Comments
 (0)