Hyperactive
Hyperactive 是一个专为 Python 设计的优化算法统一接口工具,旨在简化超参数调优、模型选择及黑盒优化实验的复杂流程。它巧妙地将“优化问题定义”与“具体算法执行”分离开来,让用户无需修改实验代码即可自由切换不同的优化策略,从而高效对比多种算法效果。
该工具主要解决了开发者在面对众多优化库时接口不统一、迁移成本高以及重复编写样板代码的痛点。无论是需要快速验证想法的机器学习工程师,还是致力于算法对比的研究人员,都能通过 Hyperactive 轻松上手。只需定义目标函数和搜索空间,即可立即运行实验。
其核心亮点在于集成了高达 31 种优化算法,涵盖局部搜索、全局搜索、基于种群及基于模型的各类方法,并统一封装了 GFO、Optuna 和 scikit-learn 三大主流后端。此外,Hyperactive 原生支持 scikit-learn、PyTorch、sktime 等流行框架,能够以极低的配置成本直接对机器学习模型进行调优。如果你希望在实验中灵活尝试不同优化器并关注结果而非底层实现细节,Hyperactive 将是一个得力的助手。
使用场景
某机器学习工程师正在为一家电商公司的销量预测模型寻找最优超参数组合,以应对复杂的非线性数据特征。
没有 Hyperactive 时
- 算法切换成本极高:想对比随机搜索、贝叶斯优化和遗传算法的效果,需要分别学习 Optuna、scikit-optimize 等不同库的 API,反复重写实验代码。
- 代码耦合严重:目标函数(模型训练逻辑)与具体的优化算法深度绑定,一旦更换策略,必须大幅修改核心业务逻辑,容易引入 Bug。
- 试错效率低下:面对 31 种可用算法,手动集成和测试不同后端(如 GFO 或 sklearn)耗时数天,导致模型迭代周期被拉长。
- 黑盒优化困难:对于非标准机器学习库的自定义目标函数,缺乏统一的接口来快速部署高效的全局搜索策略。
使用 Hyperactive 后
- 统一接口一键切换:通过 Hyperactive 标准化的实验接口,仅需修改一行配置即可在 31 种算法间自由切换,无需触碰底层实验逻辑。
- 关注点完全分离:将“定义搜索空间”与“选择优化器”解耦,工程师只需专注构建高质量的目标函数,算法调度交给 Hyperactive 自动处理。
- 快速验证最佳策略:利用其内置的 GFO、Optuna 等三大后端支持,能在几小时内完成多算法并行基准测试,迅速锁定当前数据集的最优解法。
- 无缝集成主流生态:直接调用原生集成的 scikit-learn 或 PyTorch 模块,极简配置即可启动复杂的黑盒优化任务,大幅降低接入门槛。
Hyperactive 通过统一接口消除了算法实现的碎片化,让开发者能以最低成本探索最广泛的优化策略,从而显著提升模型调优的效率与上限。
运行环境要求
- 未说明
未说明
未说明

快速开始
Python中用于优化算法和实验的统一接口。
| 文档 | ▸ | 主页 · 用户指南 · API参考 · 示例 |
| 本页内容 | ▸ | 功能特性 · 示例 · 核心概念 · 引用 |
Hyperactive 提供了跨3个后端(GFO、Optuna、scikit-learn)的31种优化算法,可通过统一的基于实验的接口访问。该库将优化问题与算法分离,使您无需更改实验代码即可切换优化器。
专为超参数调优、模型选择和黑箱优化设计。与scikit-learn、sktime、skpro和PyTorch的原生集成,让您只需最少的设置即可调优机器学习模型。只需定义目标函数、指定搜索空间并运行即可。
安装
pip install hyperactive
可选依赖
pip install hyperactive[sklearn-integration] # scikit-learn集成
pip install hyperactive[sktime-integration] # sktime/skpro集成
pip install hyperactive[all_extras] # 包括Optuna在内的所有附加功能
核心特性
|
31种优化算法 包括局部、全局、群体和基于模型的方法,覆盖3个后端(GFO、Optuna、sklearn)。 |
实验抽象 清晰地分离优化对象(实验)和优化方法(算法)。 |
灵活的搜索空间 支持离散、连续及混合类型的参数。可用NumPy数组或列表定义搜索空间。 |
|
机器学习框架集成 原生支持scikit-learn、sktime、skpro和PyTorch,只需极少的代码改动。 |
多后端支持 通过统一的API使用GFO算法、Optuna采样器以及sklearn搜索方法。 |
稳定且经过测试 超过5年的开发历程,全面的测试覆盖,自2019年以来持续维护。 |
快速入门
import numpy as np
from hyperactive.opt.gfo import HillClimbing
# 定义目标函数(最大化)
def objective(params):
x, y = params["x"], params["y"]
return -(x**2 + y**2) # 负抛物面,最优解在(0, 0)
# 定义搜索空间
search_space = {
"x": np.arange(-5, 5, 0.1),
"y": np.arange(-5, 5, 0.1),
}
# 运行优化
optimizer = HillClimbing(
search_space=search_space,
n_iter=100,
experiment=objective,
)
best_params = optimizer.solve()
print(f"最佳参数:{best_params}")
输出:
最佳参数:{'x': 0.0, 'y': 0.0}
核心概念
Hyperactive 将你优化的 内容 与 方式 分离。只需定义一次你的实验(目标函数)和搜索空间,即可在不修改代码的情况下自由切换优化器。统一的接口屏蔽了后端差异,使你可以专注于优化问题本身。
flowchart TB
subgraph USER["你的代码"]
direction LR
F["def objective(params):<br/> return score"]
SP["search_space = {<br/> 'x': np.arange(...),<br/> 'y': [1, 2, 3]<br/>}"]
end
subgraph HYPER["Hyperactive"]
direction TB
OPT["优化器"]
subgraph BACKENDS["后端"]
GFO["GFO<br/>21种算法"]
OPTUNA["Optuna<br/>8种算法"]
SKL["sklearn<br/>2种算法"]
MORE["...<br/>更多即将推出"]
end
OPT --> GFO
OPT --> OPTUNA
OPT --> SKL
OPT --> MORE
end
subgraph OUT["输出"]
BEST["best_params"]
end
F --> OPT
SP --> OPT
HYPER --> OUT
优化器:实现搜索策略(爬山法、贝叶斯优化、粒子群优化等)。
搜索空间:以 NumPy 数组或列表的形式定义有效的参数组合。
实验:你的目标函数,或内置的实验(如 SklearnCvExperiment 等)。
最佳参数:优化器返回使目标函数最大化的参数。
示例
Scikit-learn 超参数调优
from sklearn.svm import SVC
from sklearn.datasets import load_iris
from sklearn.model_selection import train_test_split
from hyperactive.integrations.sklearn import OptCV
from hyperactive.opt.gfo import HillClimbing
# 加载数据
X, y = load_iris(return_X_y=True)
X_train, X_test, y_train, y_test = train_test_split(X, y, test_size=0.2)
# 定义搜索空间和优化器
search_space = {"kernel": ["linear", "rbf"], "C": [1, 10, 100]}
optimizer = HillClimbing(search_space=search_space, n_iter=20)
# 创建调优后的估计器
tuned_svc = OptCV(SVC(), optimizer)
tuned_svc.fit(X_train, y_train)
print(f"最佳参数: {tuned_svc.best_params_}")
print(f"测试准确率: {tuned_svc.score(X_test, y_test):.3f}")
贝叶斯优化
import numpy as np
from hyperactive.opt.gfo import BayesianOptimizer
def ackley(params):
x, y = params["x"], params["y"]
return -(
-20 * np.exp(-0.2 * np.sqrt(0.5 * (x**2 + y**2)))
- np.exp(0.5 * (np.cos(2 * np.pi * x) + np.cos(2 * np.pi * y)))
+ np.e + 20
)
search_space = {
"x": np.arange(-5, 5, 0.01),
"y": np.arange(-5, 5, 0.01),
}
optimizer = BayesianOptimizer(
search_space=search_space,
n_iter=50,
experiment=ackley,
)
best_params = optimizer.solve()
粒子群优化
import numpy as np
from hyperactive.opt.gfo import ParticleSwarmOptimizer
def rastrigin(params):
A = 10
values = [params[f"x{i}"] for i in range(5)]
return -sum(v**2 - A * np.cos(2 * np.pi * v) + A for v in values)
search_space = {f"x{i}": np.arange(-5.12, 5.12, 0.1) for i in range(5)}
optimizer = ParticleSwarmOptimizer(
search_space=search_space,
n_iter=500,
experiment=rastrigin,
population_size=20,
)
best_params = optimizer.solve()
使用 SklearnCvExperiment 进行实验抽象
import numpy as np
from sklearn.svm import SVC
from sklearn.datasets import load_iris
from sklearn.metrics import accuracy_score
from sklearn.model_selection import KFold
from hyperactive.experiment.integrations import SklearnCvExperiment
from hyperactive.opt.gfo import HillClimbing
X, y = load_iris(return_X_y=True)
# 创建可重用的实验
sklearn_exp = SklearnCvExperiment(
estimator=SVC(),
scoring=accuracy_score,
cv=KFold(n_splits=3, shuffle=True),
X=X,
y=y,
)
search_space = {
"C": np.logspace(-2, 2, num=10),
"kernel": ["linear", "rbf"],
}
optimizer = HillClimbing(
search_space=search_space,
n_iter=100,
experiment=sklearn_exp,
)
best_params = optimizer.solve()
Optuna 后端(TPE)
import numpy as np
from hyperactive.opt.optuna import TPEOptimizer
def objective(params):
x, y = params["x"], params["y"]
return -(x**2 + y**2)
search_space = {
"x": np.arange(-5, 5, 0.1),
"y": np.arange(-5, 5, 0.1),
}
optimizer = TPEOptimizer(
search_space=search_space,
n_iter=100,
experiment=objective,
)
best_params = optimizer.solve()
使用 sktime 进行时间序列预测
from sktime.forecasting.naive import NaiveForecaster
from sktime.datasets import load_airline
from hyperactive.integrations.sktime import ForecastingOptCV
from hyperactive.opt.gfo import RandomSearch
y = load_airline()
search_space = {
"strategy": ["last", "mean", "drift"],
"sp": [1, 12],
}
optimizer = RandomSearch(search_space=search_space, n_iter=10)
tuned_forecaster = ForecastingOptCV(NaiveForecaster(), optimizer)
tuned_forecaster.fit(y)
print(f"最佳参数: {tuned_forecaster.best_params_}")
PyTorch 神经网络调优
import numpy as np
import torch
import torch.nn as nn
from torch.utils.data import DataLoader, TensorDataset
from hyperactive.opt.gfo import BayesianOptimizer
# 示例数据
X_train = torch.randn(1000, 10)
y_train = torch.randint(0, 2, (1000,))
def train_model(params):
learning_rate = params["learning_rate"]
batch_size = params["batch_size"]
hidden_size = params["hidden_size"]
model = nn.Sequential(
nn.Linear(10, hidden_size),
nn.ReLU(),
nn.Linear(hidden_size, 2),
)
optimizer = torch.optim.Adam(model.parameters(), lr=learning_rate)
criterion = nn.CrossEntropyLoss()
loader = DataLoader(TensorDataset(X_train, y_train), batch_size=batch_size)
model.train()
for epoch in range(10):
for X_batch, y_batch in loader:
optimizer.zero_grad()
loss = criterion(model(X_batch), y_batch)
loss.backward()
optimizer.step()
# 返回验证准确率
model.eval()
with torch.no_grad():
predictions = model(X_train).argmax(dim=1)
accuracy = (predictions == y_train).float().mean().item()
return accuracy
search_space = {
"learning_rate": np.logspace(-5, -1, 20),
"batch_size": [16, 32, 64, 128],
"hidden_size": [64, 128, 256, 512],
}
optimizer = BayesianOptimizer(
search_space=search_space,
n_iter=30,
experiment=train_model,
)
best_params = optimizer.solve()
生态系统
本库是优化与机器学习工具套件的一部分。如需了解这些包的最新动态,请在 GitHub 上关注。
| 包名 | 描述 |
|---|---|
| Hyperactive | 带有实验抽象和机器学习集成的超参数优化框架 |
| Gradient-Free-Optimizers | 用于黑箱函数优化的核心优化算法 |
| Surfaces | 用于评估优化算法的测试函数和基准曲面 |
文档
| 资源 | 描述 |
|---|---|
| 用户指南 | 全面的教程和说明 |
| API 参考 | 完整的 API 文档 |
| 示例 | 包含用例的 Jupyter 笔记本 |
| 常见问题解答 | 常见问题及故障排除 |
贡献
欢迎贡献!请参阅 CONTRIBUTING.md 获取相关指南。
- Bug 报告: GitHub Issues
- 功能请求: GitHub Discussions
- 问题咨询: Discord
引用
如果您在研究中使用本软件,请引用以下内容:
@software{hyperactive2019,
author = {Simon Blanke},
title = {Hyperactive: A hyperparameter optimization and meta-learning toolbox},
year = {2019},
url = {https://github.com/SimonBlanke/Hyperactive},
}
许可证
MIT 许可证 - 可免费用于商业和学术用途。
版本历史
v5.0.42026/03/06v5.0.32025/12/15v5.0.22025/09/21v5.0.02025/09/21v4.8.02024/08/14v4.7.02024/07/29v4.6.02023/11/01v4.5.02023/08/27v4.4.02023/03/014.32022/11/18v4.0.02021/12/01v3.2.42021/07/07v2.3.02020/07/16v2.1.02020/07/16v2.0.02020/07/16v1.1.12019/10/08v1.0.02019/09/25v0.4.22019/09/09v0.4.1.22019/07/31v0.4.02019/07/23常见问题
相似工具推荐
openclaw
OpenClaw 是一款专为个人打造的本地化 AI 助手,旨在让你在自己的设备上拥有完全可控的智能伙伴。它打破了传统 AI 助手局限于特定网页或应用的束缚,能够直接接入你日常使用的各类通讯渠道,包括微信、WhatsApp、Telegram、Discord、iMessage 等数十种平台。无论你在哪个聊天软件中发送消息,OpenClaw 都能即时响应,甚至支持在 macOS、iOS 和 Android 设备上进行语音交互,并提供实时的画布渲染功能供你操控。 这款工具主要解决了用户对数据隐私、响应速度以及“始终在线”体验的需求。通过将 AI 部署在本地,用户无需依赖云端服务即可享受快速、私密的智能辅助,真正实现了“你的数据,你做主”。其独特的技术亮点在于强大的网关架构,将控制平面与核心助手分离,确保跨平台通信的流畅性与扩展性。 OpenClaw 非常适合希望构建个性化工作流的技术爱好者、开发者,以及注重隐私保护且不愿被单一生态绑定的普通用户。只要具备基础的终端操作能力(支持 macOS、Linux 及 Windows WSL2),即可通过简单的命令行引导完成部署。如果你渴望拥有一个懂你
stable-diffusion-webui
stable-diffusion-webui 是一个基于 Gradio 构建的网页版操作界面,旨在让用户能够轻松地在本地运行和使用强大的 Stable Diffusion 图像生成模型。它解决了原始模型依赖命令行、操作门槛高且功能分散的痛点,将复杂的 AI 绘图流程整合进一个直观易用的图形化平台。 无论是希望快速上手的普通创作者、需要精细控制画面细节的设计师,还是想要深入探索模型潜力的开发者与研究人员,都能从中获益。其核心亮点在于极高的功能丰富度:不仅支持文生图、图生图、局部重绘(Inpainting)和外绘(Outpainting)等基础模式,还独创了注意力机制调整、提示词矩阵、负向提示词以及“高清修复”等高级功能。此外,它内置了 GFPGAN 和 CodeFormer 等人脸修复工具,支持多种神经网络放大算法,并允许用户通过插件系统无限扩展能力。即使是显存有限的设备,stable-diffusion-webui 也提供了相应的优化选项,让高质量的 AI 艺术创作变得触手可及。
everything-claude-code
everything-claude-code 是一套专为 AI 编程助手(如 Claude Code、Codex、Cursor 等)打造的高性能优化系统。它不仅仅是一组配置文件,而是一个经过长期实战打磨的完整框架,旨在解决 AI 代理在实际开发中面临的效率低下、记忆丢失、安全隐患及缺乏持续学习能力等核心痛点。 通过引入技能模块化、直觉增强、记忆持久化机制以及内置的安全扫描功能,everything-claude-code 能显著提升 AI 在复杂任务中的表现,帮助开发者构建更稳定、更智能的生产级 AI 代理。其独特的“研究优先”开发理念和针对 Token 消耗的优化策略,使得模型响应更快、成本更低,同时有效防御潜在的攻击向量。 这套工具特别适合软件开发者、AI 研究人员以及希望深度定制 AI 工作流的技术团队使用。无论您是在构建大型代码库,还是需要 AI 协助进行安全审计与自动化测试,everything-claude-code 都能提供强大的底层支持。作为一个曾荣获 Anthropic 黑客大奖的开源项目,它融合了多语言支持与丰富的实战钩子(hooks),让 AI 真正成长为懂上
ComfyUI
ComfyUI 是一款功能强大且高度模块化的视觉 AI 引擎,专为设计和执行复杂的 Stable Diffusion 图像生成流程而打造。它摒弃了传统的代码编写模式,采用直观的节点式流程图界面,让用户通过连接不同的功能模块即可构建个性化的生成管线。 这一设计巧妙解决了高级 AI 绘图工作流配置复杂、灵活性不足的痛点。用户无需具备编程背景,也能自由组合模型、调整参数并实时预览效果,轻松实现从基础文生图到多步骤高清修复等各类复杂任务。ComfyUI 拥有极佳的兼容性,不仅支持 Windows、macOS 和 Linux 全平台,还广泛适配 NVIDIA、AMD、Intel 及苹果 Silicon 等多种硬件架构,并率先支持 SDXL、Flux、SD3 等前沿模型。 无论是希望深入探索算法潜力的研究人员和开发者,还是追求极致创作自由度的设计师与资深 AI 绘画爱好者,ComfyUI 都能提供强大的支持。其独特的模块化架构允许社区不断扩展新功能,使其成为当前最灵活、生态最丰富的开源扩散模型工具之一,帮助用户将创意高效转化为现实。
gemini-cli
gemini-cli 是一款由谷歌推出的开源 AI 命令行工具,它将强大的 Gemini 大模型能力直接集成到用户的终端环境中。对于习惯在命令行工作的开发者而言,它提供了一条从输入提示词到获取模型响应的最短路径,无需切换窗口即可享受智能辅助。 这款工具主要解决了开发过程中频繁上下文切换的痛点,让用户能在熟悉的终端界面内直接完成代码理解、生成、调试以及自动化运维任务。无论是查询大型代码库、根据草图生成应用,还是执行复杂的 Git 操作,gemini-cli 都能通过自然语言指令高效处理。 它特别适合广大软件工程师、DevOps 人员及技术研究人员使用。其核心亮点包括支持高达 100 万 token 的超长上下文窗口,具备出色的逻辑推理能力;内置 Google 搜索、文件操作及 Shell 命令执行等实用工具;更独特的是,它支持 MCP(模型上下文协议),允许用户灵活扩展自定义集成,连接如图像生成等外部能力。此外,个人谷歌账号即可享受免费的额度支持,且项目基于 Apache 2.0 协议完全开源,是提升终端工作效率的理想助手。
markitdown
MarkItDown 是一款由微软 AutoGen 团队打造的轻量级 Python 工具,专为将各类文件高效转换为 Markdown 格式而设计。它支持 PDF、Word、Excel、PPT、图片(含 OCR)、音频(含语音转录)、HTML 乃至 YouTube 链接等多种格式的解析,能够精准提取文档中的标题、列表、表格和链接等关键结构信息。 在人工智能应用日益普及的今天,大语言模型(LLM)虽擅长处理文本,却难以直接读取复杂的二进制办公文档。MarkItDown 恰好解决了这一痛点,它将非结构化或半结构化的文件转化为模型“原生理解”且 Token 效率极高的 Markdown 格式,成为连接本地文件与 AI 分析 pipeline 的理想桥梁。此外,它还提供了 MCP(模型上下文协议)服务器,可无缝集成到 Claude Desktop 等 LLM 应用中。 这款工具特别适合开发者、数据科学家及 AI 研究人员使用,尤其是那些需要构建文档检索增强生成(RAG)系统、进行批量文本分析或希望让 AI 助手直接“阅读”本地文件的用户。虽然生成的内容也具备一定可读性,但其核心优势在于为机器