semvec/pypi-packages huggingface dataset:
xgolib 1.0.5
XGO 机器人控制库
Requires Python: >=3.8

# xgolib — XGO 机器人控制库
xgolib 提供了针对 XGO 系列设备的 Python 控制接口。通过统一入口 `XGO(...)` 可自动识别设备类型并返回对应的控制对象，亦可手动指定型号。

- 已支持设备：`XGO-MINI`、`XGO-LITE`、`XGO-MINI3W`、`XGO-RIDER`

## 安装

- Python 版本：建议 `3.8+`
- 依赖：`pyserial`

```bash
pip install pyserial
pip install xgolib
```
evented 1.1.0
Event emitters.
Requires Python: >=3.13

# Evented

[![PyPI License](https://img.shields.io/pypi/l/evented.svg)](https://pypi.org/project/evented/)
[![Package status](https://img.shields.io/pypi/status/evented.svg)](https://pypi.org/project/evented/)
[![Monthly downloads](https://img.shields.io/pypi/dm/evented.svg)](https://pypi.org/project/evented/)
[![Distribution format](https://img.shields.io/pypi/format/evented.svg)](https://pypi.org/project/evented/)
[![Wheel availability](https://img.shields.io/pypi/wheel/evented.svg)](https://pypi.org/project/evented/)
[![Python version](https://img.shields.io/pypi/pyversions/evented.svg)](https://pypi.org/project/evented/)
[![Implementation](https://img.shields.io/pypi/implementation/evented.svg)](https://pypi.org/project/evented/)
[![Releases](https://img.shields.io/github/downloads/phil65/evented/total.svg)](https://github.com/phil65/evented/releases)
[![Github Contributors](https://img.shields.io/github/contributors/phil65/evented)](https://github.com/phil65/evented/graphs/contributors)
[![Github Discussions](https://img.shields.io/github/discussions/phil65/evented)](https://github.com/phil65/evented/discussions)
[![Github Forks](https://img.shields.io/github/forks/phil65/evented)](https://github.com/phil65/evented/forks)
[![Github Issues](https://img.shields.io/github/issues/phil65/evented)](https://github.com/phil65/evented/issues)
[![Github Issues](https://img.shields.io/github/issues-pr/phil65/evented)](https://github.com/phil65/evented/pulls)
[![Github Watchers](https://img.shields.io/github/watchers/phil65/evented)](https://github.com/phil65/evented/watchers)
[![Github Stars](https://img.shields.io/github/stars/phil65/evented)](https://github.com/phil65/evented/stars)
[![Github Repository size](https://img.shields.io/github/repo-size/phil65/evented)](https://github.com/phil65/evented)
[![Github last commit](https://img.shields.io/github/last-commit/phil65/evented)](https://github.com/phil65/evented/commits)
[![Github release date](https://img.shields.io/github/release-date/phil65/evented)](https://github.com/phil65/evented/releases)
[![Github language count](https://img.shields.io/github/languages/count/phil65/evented)](https://github.com/phil65/evented)
[![Github commits this month](https://img.shields.io/github/commit-activity/m/phil65/evented)](https://github.com/phil65/evented)
[![Package status](https://codecov.io/gh/phil65/evented/branch/main/graph/badge.svg)](https://codecov.io/gh/phil65/evented/)
[![PyUp](https://pyup.io/repos/github/phil65/evented/shield.svg)](https://pyup.io/repos/github/phil65/evented/)

[Read the documentation!](https://phil65.github.io/evented/)
mectl 0.1.1
A command line tool for downloading files from MinIO
Requires Python: >=3.10

README.md
# mectl

`mectl` 是一个命令行工具，用于辅助mindedge的模型开发，例如从 MinIO 服务器下载文件。

## 功能特性

- 通过命令行从 MinIO 服务器下载文件
- 支持通过配置文件或环境变量设置连接参数
- 灵活的输出路径配置
- 支持指定存储桶名称
- 自动从文件路径提取文件名
- 自动检测并解压ZIP文件
- 上传文件到 MinIO 并创建模型记录

## 安装

```bash
# 使用 pip 安装
pip install mectl
```

## 使用方法

### 基本用法

```bash
mectl get [OPTIONS] FILE_KEY
```

### 上传文件

```bash
mectl upload [OPTIONS] FILE_PATH
```

### 参数说明

#### 下载参数
- `FILE_KEY`: MinIO 对象路径，格式：`bucket_name/object_key`
- `-o, --output`: 本地保存路径（默认为从 FILE_KEY 提取的文件名）
- `-c, --config`: 配置文件路径（JSON，含 oss.accessKey 等）
- `-b, --bucket`: MinIO 存储桶名称（默认为 `suanpan`）

#### 上传参数
- `FILE_PATH`: 本地文件路径
- `-c, --config`: 配置文件路径（JSON，含 oss.accessKey 等）
- `-b, --bucket`: MinIO 存储桶名称（默认为 `suanpan`）

### 配置

工具需要通过配置文件或环境变量提供 MinIO 连接信息。

#### 配置文件示例 (config.json)

```json
{
  "oss": {
    "internalEndpoint": "your-minio-server.com:9000",
    "accessKey": "your-access-key",
    "accessSecret": "your-access-secret"
  }
}
```

#### 环境变量方式

```bash
export NODE_CONFIG='{"oss":{"internalEndpoint":"your-minio-server.com:9000","accessKey":"your-access-key","accessSecret":"your-access-secret"}}'
mectl get bucket-name/file-path
```

### 使用示例

#### 下载文件示例
```bash
# 使用配置文件下载文件
mectl get my-file.txt -c config.json -o ./local-file.txt

# 使用环境变量下载文件（自动提取文件名）
mectl get studio/100029/models/MindEdge.zip -c config.json

# 指定特定存储桶
mectl get my-file.txt -b another-bucket -c config.json
```

#### 上传文件示例
```bash
# 上传文件到 MinIO
mectl upload ./local-model.zip -c config.json

# 上传到指定存储桶
mectl upload ./local-model.zip -b another-bucket -c config.json
```

上传时需要设置以下环境变量：
```bash
export SP_USER_ID=your-user-id
export SP_HOST=your-host-url
```

上传完成后，工具会提示输入模型名称和描述，然后自动创建模型记录。

## 开发

### 本地运行

```bash
# 克隆项目
git clone <repository-url>

# 安装依赖
cd mectl
pip install -e .
```

## 发布到 PyPI

要发布新版本到 PyPI，请执行以下步骤：

1. 更新 [pyproject.toml](file:///home/luxu/project/mindedge-model-tool/pyproject.toml) 中的版本号
2. 运行测试确保一切正常
3. 使用发布脚本发布：

```bash
# 运行发布脚本
./release.sh
```

发布脚本将：
- 检查环境和依赖
- 构建包
- 询问发布目标（测试PyPI或正式PyPI）
- 执行发布

## 依赖

- Python >= 3.10
- minio >= 7.0.0
pygbm-xzy 0.1.0.post3
A Python package for simulating Geometric Brownian Motion (GBM).
Requires Python: >=3.9
Keywords: brownian motion, stochastic processes

# pygbm — Geometric Brownian Motion Simulator

`pygbm` is a lightweight Python package for simulating **Geometric Brownian Motion (GBM)** paths.
It provides both a Python API and a command-line interface, with documentation hosted on Read the Docs.

**Documentation**  
https://geometric-brownian-motion-simulations.readthedocs.io/en/latest/

---

## Installation

### Install from PyPI

Once published on PyPI, the package can be installed directly via:

    pip install pygbm_xzy

---

### Install from Source (Editable Mode)

Alternatively, clone the repository and install the package in editable mode:

    git clone https://github.com/ZZZiyao/Geometric-Brownian-motion-simulations.git
    cd Geometric-Brownian-motion-simulations
    pip install -e .

---

## Description

Geometric Brownian Motion (GBM) is a stochastic process commonly used to model
multiplicative random dynamics. It satisfies the stochastic differential equation:

    dY(t) = μ Y(t) dt + σ Y(t) dB(t)

where μ is the drift coefficient and σ is the diffusion coefficient.

---

## Features

- Object-oriented design with a shared base class
- Simulation of GBM paths using the analytical solution
- Simple Python interface
- Command-line interface
- Automatically generated documentation using Sphinx and Read the Docs

---

## Usage

### Python Interface

    from pygbm.gbm_simulator import GBMSimulator

    simulator = GBMSimulator(y0=1.0, mu=0.05, sigma=0.2)
    t_values, y_values = simulator.simulate_path(T=1.0, N=100)
    simulator.plot_path(t_values, y_values, output="gbm_plot.png")

---

### Command-Line Interface

    pygbm simulate --y0 1.0 --mu 0.05 --sigma 0.2 --T 1.0 --N 100 --output gbm_plot.png

---

## Documentation

Full documentation, including the API reference and an example notebook, is available at:

https://geometric-brownian-motion-simulations.readthedocs.io/en/latest/pygbm

The documentation is automatically built and published using **Read the Docs**.

---

## Contributing

Contributions are welcome.  
Fork the repository and submit a pull request.

---

## License

This project is licensed under the MIT License.
searchly 2.1.0
Search tools for agents
Requires Python: >=3.13

# Searchly

[![PyPI License](https://img.shields.io/pypi/l/searchly.svg)](https://pypi.org/project/searchly/)
[![Package status](https://img.shields.io/pypi/status/searchly.svg)](https://pypi.org/project/searchly/)
[![Monthly downloads](https://img.shields.io/pypi/dm/searchly.svg)](https://pypi.org/project/searchly/)
[![Distribution format](https://img.shields.io/pypi/format/searchly.svg)](https://pypi.org/project/searchly/)
[![Wheel availability](https://img.shields.io/pypi/wheel/searchly.svg)](https://pypi.org/project/searchly/)
[![Python version](https://img.shields.io/pypi/pyversions/searchly.svg)](https://pypi.org/project/searchly/)
[![Implementation](https://img.shields.io/pypi/implementation/searchly.svg)](https://pypi.org/project/searchly/)
[![Releases](https://img.shields.io/github/downloads/phil65/searchly/total.svg)](https://github.com/phil65/searchly/releases)
[![Github Contributors](https://img.shields.io/github/contributors/phil65/searchly)](https://github.com/phil65/searchly/graphs/contributors)
[![Github Discussions](https://img.shields.io/github/discussions/phil65/searchly)](https://github.com/phil65/searchly/discussions)
[![Github Forks](https://img.shields.io/github/forks/phil65/searchly)](https://github.com/phil65/searchly/forks)
[![Github Issues](https://img.shields.io/github/issues/phil65/searchly)](https://github.com/phil65/searchly/issues)
[![Github Issues](https://img.shields.io/github/issues-pr/phil65/searchly)](https://github.com/phil65/searchly/pulls)
[![Github Watchers](https://img.shields.io/github/watchers/phil65/searchly)](https://github.com/phil65/searchly/watchers)
[![Github Stars](https://img.shields.io/github/stars/phil65/searchly)](https://github.com/phil65/searchly/stars)
[![Github Repository size](https://img.shields.io/github/repo-size/phil65/searchly)](https://github.com/phil65/searchly)
[![Github last commit](https://img.shields.io/github/last-commit/phil65/searchly)](https://github.com/phil65/searchly/commits)
[![Github release date](https://img.shields.io/github/release-date/phil65/searchly)](https://github.com/phil65/searchly/releases)
[![Github language count](https://img.shields.io/github/languages/count/phil65/searchly)](https://github.com/phil65/searchly)
[![Github commits this month](https://img.shields.io/github/commit-activity/m/phil65/searchly)](https://github.com/phil65/searchly)
[![Package status](https://codecov.io/gh/phil65/searchly/branch/main/graph/badge.svg)](https://codecov.io/gh/phil65/searchly/)
[![PyUp](https://pyup.io/repos/github/phil65/searchly/shield.svg)](https://pyup.io/repos/github/phil65/searchly/)

[Read the documentation!](https://phil65.github.io/searchly/)
supertuxkart.py 0.2.2
A wrapper for the SuperTuxKart Online Service (STKAddons) API
Requires Python: >=3.10

# SuperTuxKart Online Service API Wrapper
![Python Version from PEP 621 TOML](https://img.shields.io/python/required-version-toml?tomlFilePath=https%3A%2F%2Fcodeberg.org%2FlinaSTK%2Fstk.py%2Fraw%2Fbranch%2Fmain%2Fpyproject.toml)
![PyPI - License](https://img.shields.io/pypi/l/supertuxkart.py)
![Gitea Stars](https://img.shields.io/gitea/stars/linaSTK/stk.py?gitea_url=https%3A%2F%2Fcodeberg.org&style=flat)
![Gitea Last Commit](https://img.shields.io/gitea/last-commit/linaSTK/stk.py?gitea_url=https%3A%2F%2Fcodeberg.org)

A library that allows for interacting with teh SuperTuxKart Online Service ("STKAddons") API.

# Install
You can install supertuxkart.py using the following command:
```
pip install supertuxkart.py
```
... or if you want to use the git/development version:
```
pip install git+https://codeberg.org/linaSTK/stk.py
```

# Example:
```py
>>> import supertuxkart
>>> client = supertuxkart.SuperTuxKartClient(userid=513714, token="<token here>")
>>> # You can also use username/password auth, though
>>> # userid/token is prioritized if both specified
>>> client = supertuxkart.SuperTuxKartClient(username="Sayori", password="password")
>>> session = client.account.authorize()
>>> session
<SessionInfo token=xxxxxxxxxxxxxxxxxxxxxxxx username=Sayori realname=Sayori userid=513714 achieved=[2, 3, 5, 7, 8, 9]>
```

# License
This project is licensed under the MIT license.
article-mcp 0.2.2
Article MCP文献搜索服务器 - 基于Europe PMC、arXiv等多个数据源的学术文献搜索工具
Requires Python: >=3.10
Keywords: mcp, literature, search, europe-pmc, arxiv, academic

# Article MCP 文献搜索服务器

[![MCP Server](https://glama.ai/mcp/servers/@gqy20/article-mcp/badge)](https://glama.ai/mcp/servers/@gqy20/article-mcp)

基于 FastMCP v2.13+ 的异步文献搜索工具，集成 Europe PMC、PubMed、arXiv、CrossRef、OpenAlex 等数据源。

## 快速开始

```bash
# 安装
uvx article-mcp

# 或本地开发
git clone https://github.com/gqy20/article-mcp.git && cd article-mcp
uv sync
uv run python -m article_mcp
```

## 配置

### Claude Desktop

```json
{
  "mcpServers": {
    "article-mcp": {
      "command": "uvx",
      "args": ["article-mcp"],
      "env": {
        "EASYSCHOLAR_SECRET_KEY": "your_key_here"
      }
    }
  }
}
```

`EASYSCHOLAR_SECRET_KEY` 为可选项，访问 [EasyScholar](https://www.easyscholar.cc) 注册获取。

### Cherry Studio

同上，如遇 Unicode 问题添加 `env: {"PYTHONIOENCODING": "utf-8"}`

## 5 个核心工具

| 工具 | 功能 | 数据源 | 主要参数 |
|------|------|--------|----------|
| `search_literature` | 多源文献搜索 | Europe PMC, PubMed, arXiv, CrossRef, OpenAlex | `keyword`, `max_results` |
| `get_article_details` | 获取文献详情（支持参数容错） | Europe PMC, CrossRef, OpenAlex, arXiv, PubMed | `identifier`, `id_type`, `sources` |
| `get_references` | 获取参考文献 | Europe PMC, CrossRef, PubMed | `identifier`, `max_results` |
| `get_literature_relations` | 文献关系分析 | Europe PMC, PubMed, CrossRef, OpenAlex | `identifiers`, `relation_types` |
| `get_journal_quality` | 期刊质量评估 | EasyScholar, OpenAlex | `journal_name`, `include_metrics` |

## 数据源说明

### Europe PMC
- **内容**：生物医学文献全文、摘要
- **限制**：1 req/s
- **用途**：搜索、全文获取、参考文献

### PubMed
- **内容**：生物医学文献摘要
- **限制**：无严格限制
- **用途**：搜索补充

### arXiv
- **内容**：预印本论文
- **限制**：3 req/request
- **用途**：预印本搜索

### CrossRef
- **内容**：跨出版社元数据
- **限制**：50 req/s
- **用途**：参考文献查询

### OpenAlex
- **内容**：开放学术图谱
- **限制**：无限制
- **用途**：引用关系、h 指标

### EasyScholar
- **内容**：期刊质量指标
- **限制**：建议配置密钥
- **用途**：影响因子、分区

## 使用示例

```json
// 搜索（默认使用 Europe PMC + PubMed）
{"keyword": "machine learning", "max_results": 10}

// 指定数据源搜索
{"keyword": "cancer", "sources": ["europe_pmc", "arxiv"]}

// 获取全文
{"pmcid": "PMC1234567"}

// 获取指定章节
{"pmcid": "PMC1234567", "sections": ["methods", "results"]}

// 批量获取
{"pmcid": ["PMC123", "PMC456"]}

// 获取参考文献（默认 Europe PMC + CrossRef）
{"identifier": "10.1038/nature12373", "max_results": 20}

// 文献关系分析
{"identifiers": "10.1038/nature12373", "relation_types": ["references", "similar"]}

// 期刊质量（EasyScholar + OpenAlex 双源）
{"journal_name": "Nature", "include_metrics": ["impact_factor", "h_index"]}
```

## 参数容错特性

`get_article_details` 工具会自动修正以下格式错误：

| 输入 | 自动修正为 |
|------|-----------|
| `"pmcid": "[\"a\", \"b\"]"` | `["a", "b"]` |
| `"sections": "methods"` | `["methods"]` |

## API 限制汇总

| API | 限制 | 用途 |
|-----|------|------|
| Europe PMC | 1 req/s | 全文、参考文献 |
| Crossref | 50 req/s | 参考文献 |
| arXiv | 3 req/request | 预印本 |
| OpenAlex | 无限制 | 引用关系、指标 |
| EasyScholar | 建议配置密钥 | 期刊质量 |

## 故障排除

| 问题 | 解决方案 |
|------|---------|
| `cannot import 'hdrs' from 'aiohttp'` | `uv sync --upgrade` |
| MCP 服务器启动失败 | 检查配置中的路径是否使用绝对路径 |
| API 请求失败 | 检查网络连接 |
| 期刊质量数据缺失 | 配置 `EASYSCHOLAR_SECRET_KEY` |

## 许可证

MIT License
tg-server-bot 0.0.2
A Telegram bot for Linux server management and shell execution.
Requires Python: >=3.8

# Telegram Server Bot (tg-server-bot)

一个轻量级、功能强大的 Telegram 机器人，专为 Linux 服务器管理而设计。支持通过 Telegram 执行 Shell 命令、下载服务器文件、查询 IP 等操作，并具备完善的权限管理机制。

## ✨ 核心特性

*   **🛡️ 权限管理**：基于 Telegram User ID 的白名单机制，拒绝未授权访问。
*   **💻 远程 Shell**：直接在聊天窗口执行 Shell 命令，支持自动补全。
*   **📂 文件下载**：快速下载服务器上的指定文件（如日志、配置文件）。
*   **🌐 网络工具**：一键查询服务器 IPv4/IPv6 地址。
*   **⚙️ 灵活配置**：支持自定义快捷指令、工作目录切换。
*   **📦 开箱即用**：提供 `tg-bot-cfg` 和 `tg-bot-auth` 辅助工具，快速管理配置。

## 🚀 安装

确保您的系统已安装 Python 3.8+。

```bash
# 1. 克隆仓库
git clone https://github.com/your-repo/tg-server-bot.git
cd tg-server-bot

# 2. 安装 (推荐在虚拟环境中)
pip install .
```

安装完成后，系统将获得以下三个命令：
*   `tg-bot`: 启动机器人主程序。
*   `tg-bot-cfg`: 快速编辑配置文件。
*   `tg-bot-auth`: 快速管理授权用户白名单。

## 📖 快速开始

### 1. 初始化配置
首次运行配置工具会自动生成默认配置文件。

```bash
# 打开配置文件编辑器 (默认使用 vim/nano/notepad)
tg-bot-cfg
```

在打开的编辑器中，填入您的 Telegram Bot Token：
```ini
[common]
token = 123456789:ABCdefGHIjklMNOpqrsTUVwxyz
```

### 2. 添加授权用户
为了安全起见，机器人默认拒绝所有请求。您需要将自己的 Telegram User ID 添加到白名单。

**获取 User ID 的方法**：在 Telegram 中向 [@userinfobot](https://t.me/userinfobot) 发送 `/start`，它会返回您的 ID（一串数字，如 `123456789`）。

```bash
# 打开白名单编辑器
tg-bot-auth
```

在文件中输入您的 ID，每行一个。

### 3. 启动机器人

```bash
# 前台运行 (日志输出到终端)
tg-bot

# 后台运行 (推荐，日志自动记录到配置文件指定的 log_file)
nohup tg-bot > /dev/null 2>&1 &
```

现在，您可以在 Telegram 中向机器人发送 `/start` 开始使用了！

## 🛠️ 命令详解

### 主程序 `tg-bot`

```bash
usage: tg-bot [-h] [-v] [-c CONFIG]

options:
  -h, --help            显示帮助信息
  -v, --version         显示版本号和安装路径
  -c CONFIG, --config CONFIG
                        指定配置文件路径 (默认为安装目录下的 config.ini)
```

**日志逻辑说明**：
*   **直接运行** (`tg-bot`)：日志输出到终端。
*   **重定向运行** (`tg-bot > log.txt`)：日志输出到文件。
*   **配置文件日志**：如果在 `config.ini` 中设置了 `log_file`，日志会**额外**写入该文件。

### 配置工具 `tg-bot-cfg`

```bash
usage: tg-bot-cfg [-h] [-c CONFIG] [-e]

options:
  -c CONFIG, --config CONFIG
                        编辑指定的配置文件
  -e, --example         查看配置文件模板内容
```

### 授权工具 `tg-bot-auth`

```bash
usage: tg-bot-auth [-h] [-e]

options:
  -e, --example         查看白名单文件模板内容
```

## ⚙️ 配置文件说明 (`config.ini`)

```ini
[common]
; 您的 Bot Token (必填)
token = 123456...

; 代理设置 (可选，如国内服务器无法连接 Telegram API)
; proxy = http://127.0.0.1:7890

; 日志文件路径 (可选)
; 如果留空，则不记录到文件，仅输出到 stdout
log_file = tg_bot.log

; 机器人运行的工作目录 (可选)
; 所有 Shell 命令和文件下载将以此目录为基准
; 默认为启动 tg-bot 时的目录
pwd = /home/ubuntu/my-project

[get]
; 文件下载快捷指令 (格式: 指令名 = 文件路径)
; 发送 /hosts 即可下载 /etc/hosts
hosts = /etc/hosts
nginx = /etc/nginx/nginx.conf

[run_cmds]
; Shell 执行快捷指令 (格式: 指令名 = Shell 命令)
; 发送 /status 即可执行对应的命令
status = systemctl status nginx
disk = df -h
```

## 🎮 Telegram 交互指令

| 指令 | 说明 |
| :--- | :--- |
| `/start` | 唤起控制面板 |
| `/list` | 列出所有可用指令（含自定义指令） |
| `/ip` | 查询服务器 IPv4 地址 |
| `/ipv6` | 查询服务器 IPv6 地址 |
| `/run <cmd>` | 执行任意 Shell 命令 (如 `/run ls -la`) |
| `/add_get <name> <path>` | **动态**添加文件下载指令 (立即生效) |
| `/add_run <name> <cmd>` | **动态**添加 Shell 指令 (立即生效) |
| `/clear` | 清除所有动态添加的临时指令 |

## ⚠️ 安全建议

1.  **严格管理白名单**：不要将 `verified_id.txt` 泄露给他人。
2.  **谨慎使用 `/run`**：该指令具有极高的权限（取决于运行机器人的用户权限）。建议使用非 root 用户运行本程序。
3.  **不要将 Token 提交到公开仓库**。

## 📝 License

MIT License