py3model 0.1.0__tar.gz

py3model-0.1.0/.mailmap

@@ -0,0 +1 @@
+zxl20070701 <1904314465@qq.com>

py3model-0.1.0/AUTHORS.txt

@@ -0,0 +1,6 @@
+Authors ordered by first contribution.
+
+zxl20070701 <1904314465@qq.com> <https://github.com/zxl20070701>
+
+-----------------------------------------------------
+We thank all of them for their contributions!

py3model-0.1.0/CHANGELOG

@@ -0,0 +1,17 @@
+v0.1.0:
+    date:2026-09-02
+    changes:
+      - 初始化版本
+        1、提供 py3model 命令行工具，安装后执行 `py3model` 即可启动本地 GGUF 模型服务
+        2、内置 tkinter 可视化界面，支持选择 GGUF 文件、配置推理参数（基础 + 高级，分组折叠展示）、查看服务状态、复制 base_url、内置多轮测试对话（支持流式输出）
+        3、内置基于标准库 http.server 的 ThreadingHTTPServer，提供 OpenAI 兼容的 HTTP 接口：
+          - POST /v1/chat/completions（支持流式 SSE 与非流式）
+          - POST /v1/completions
+          - GET  /v1/models
+          - GET  /health
+          - POST /v1/internal/load
+          - POST /v1/internal/unload
+        4、封装 llama_cpp.Llama 为单例加载/卸载（load_model / unload_model），维护 LLAMA_PARAMS 参数元数据（含默认值、类型、悬浮提示说明）
+        5、推理层使用 ChatML 模板拼接 messages，并提供 stream_chat / non_stream_chat / stream_complete / non_stream_complete
+        6、支持 ~/.py3model/config.json 持久化配置（模型路径、推理参数、host、port 等），原子写入并向前兼容
+        7、跨平台支持（Windows / macOS / Linux），含 HiDPI 自适应与窗口最大化处理；支持 --host、--port、--no-gui 命令行参数

py3model-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) zxl20070701 走一步，再走一步
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

py3model-0.1.0/MANIFEST.in

@@ -0,0 +1,7 @@
+include LICENSE
+include README.md
+include CHANGELOG
+include AUTHORS.txt
+include .mailmap
+include logo.jpeg
+include docs/*

py3model-0.1.0/PKG-INFO

@@ -0,0 +1,70 @@
+Metadata-Version: 2.4
+Name: py3model
+Version: 0.1.0
+Summary: 提供python3版本的本地模型文件运行脚本或命令
+Home-page: https://github.com/aihatch/py3model
+Author: zxl20070701
+Author-email: 1904314465@qq.com
+Maintainer: zxl20070701
+Maintainer-email: 1904314465@qq.com
+License: MIT
+Keywords: gguf,model,python3
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Description-Content-Type: text/markdown
+License-File: LICENSE
+License-File: AUTHORS.txt
+Requires-Dist: llama-cpp-python==0.3.23
+Dynamic: author
+Dynamic: author-email
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: home-page
+Dynamic: keywords
+Dynamic: license
+Dynamic: license-file
+Dynamic: maintainer
+Dynamic: maintainer-email
+Dynamic: requires-dist
+Dynamic: summary
+
+<img src="./logo.jpeg" />
+
+# [py3model](https://github.com/aihatch/py3model)
+⏰ 提供python3版本的本地模型文件运行脚本或命令
+
+<p>
+    <a href="https://github.com/aihatch/py3model" target='_blank'>
+        <img alt="GitHub repo stars" src="https://img.shields.io/github/stars/aihatch/py3model?style=social">
+    </a>
+</p>
+
+## 使用
+
+首先需要进行安装：
+
+```
+pip3 install py3model
+```
+
+然后就可以使用了，只需要打开命令行执行：
+
+```
+py3model
+```
+
+就可以出现可视化界面，帮助你快速本地启动下载的GGUF等模型文件，作为LLM服务器使用。
+
+## 文档
+
+- [安装与启动](https://github.com/aihatch/py3model/blob/master/docs/install.md)
+- [配置文件](https://github.com/aihatch/py3model/blob/master/docs/config.md)
+- [HTTP API（OpenAI 兼容）](https://github.com/aihatch/py3model/blob/master/docs/api.md)
+
+## 版权
+
+MIT License
+
+Copyright (c) [zxl20070701](https://zxl20070701.github.io/notebook/home.html) 走一步，再走一步

py3model-0.1.0/README.md

@@ -0,0 +1,38 @@
+<img src="./logo.jpeg" />
+
+# [py3model](https://github.com/aihatch/py3model)
+⏰ 提供python3版本的本地模型文件运行脚本或命令
+
+<p>
+    <a href="https://github.com/aihatch/py3model" target='_blank'>
+        <img alt="GitHub repo stars" src="https://img.shields.io/github/stars/aihatch/py3model?style=social">
+    </a>
+</p>
+
+## 使用
+
+首先需要进行安装：
+
+```
+pip3 install py3model
+```
+
+然后就可以使用了，只需要打开命令行执行：
+
+```
+py3model
+```
+
+就可以出现可视化界面，帮助你快速本地启动下载的GGUF等模型文件，作为LLM服务器使用。
+
+## 文档
+
+- [安装与启动](./docs/install.md)
+- [配置文件](./docs/config.md)
+- [HTTP API（OpenAI 兼容）](./docs/api.md)
+
+## 版权
+
+MIT License
+
+Copyright (c) [zxl20070701](https://zxl20070701.github.io/notebook/home.html) 走一步，再走一步

py3model-0.1.0/docs/api.md

@@ -0,0 +1,221 @@
+# HTTP API
+
+base_url：`http://127.0.0.1:11434`
+
+兼容 OpenAI 接口协议，可直接用 OpenAI Python SDK、LangChain、Cursor 等工具接入。
+
+## 公共约定
+
+- 请求/响应均为 JSON（流式接口使用 SSE）
+- `Content-Type: application/json`
+- 所有错误响应形如：`{"error": {"message": "...", "type": "..."}}`
+
+### 错误码
+
+| 状态码 | `type` | 触发场景 |
+|---|---|---|
+| 400 | `bad_request` | 请求体不是合法 JSON / 缺必填字段（`messages`、`prompt` 等） |
+| 400 | `bad_request` | `/v1/internal/load` 的 `model_path` 无效或非整数参数 |
+| 404 | `not_found` | 未匹配的路由 |
+| 500 | `internal_error` | 推理时未预期的异常 |
+| 500 | `load_error` | `/v1/internal/load` 加载模型失败 |
+| 503 | `model_not_loaded` | 尚未加载模型就请求推理 |
+
+### 模板说明
+
+`/v1/chat/completions` 内部使用 **ChatML** 模板拼接 `messages`，并以 `` ` `` 包裹的特殊 token `<|im_end|>` 作为默认停止符（兼容 Qwen、多数中文模型）：
+
+```text
+<|im_start|>system
+{content}<|im_end|>
+<|im_start|>user
+{content}<|im_end|>
+<|im_start|>assistant
+```
+
+`/v1/completions` 则直接把 `prompt` 字段透传给 llama.cpp，不加任何额外模板。
+
+---
+
+## POST /v1/chat/completions
+
+聊天补全。OpenAI 兼容，支持流式与非流式。
+
+### 请求体
+
+```json
+{
+  "messages": [
+    {"role": "system", "content": "你是一个有帮助的助手。"},
+    {"role": "user", "content": "你好"}
+  ],
+  "temperature": 0.7,
+  "max_tokens": 1024,
+  "stream": true
+}
+```
+
+| 字段 | 类型 | 必填 | 说明 |
+|---|---|---|---|
+| `messages` | array | 是 | 消息列表，每项含 `role` 与 `content` |
+| `temperature` | float | 否 | 采样温度，默认 0.7 |
+| `max_tokens` | int | 否 | 最大生成 token 数，默认 1024 |
+| `stream` | bool | 否 | 是否流式输出，默认 false |
+| `stop` | string 或 array | 否 | 停止符，默认 `<|im_end|>` |
+
+### 非流式响应
+
+```json
+{
+  "id": "chatcmpl-...",
+  "object": "chat.completion",
+  "created": 1700000000,
+  "model": "gguf-local",
+  "choices": [{
+    "index": 0,
+    "message": {"role": "assistant", "content": "你好！"},
+    "finish_reason": "stop"
+  }],
+  "usage": {"prompt_tokens": 0, "completion_tokens": 0, "total_tokens": 0}
+}
+```
+
+> 说明：`usage` 字段目前全部填 0，llama-cpp-python 未直接暴露 token 计数。
+
+### 流式响应（SSE）
+
+```
+data: {"id":"...","object":"chat.completion.chunk","choices":[{"delta":{"role":"assistant"},"index":0,"finish_reason":null}]}
+
+data: {"id":"...","object":"chat.completion.chunk","choices":[{"delta":{"content":"你"},"index":0,"finish_reason":null}]}
+
+...
+
+data: [DONE]
+```
+
+---
+
+## POST /v1/completions
+
+文本补全。
+
+### 请求体
+
+```json
+{
+  "prompt": "Q: 你叫什么？\nA:",
+  "temperature": 0.7,
+  "max_tokens": 512,
+  "stream": false
+}
+```
+
+| 字段 | 类型 | 必填 | 说明 |
+|---|---|---|---|
+| `prompt` | string | 是 | 输入提示词 |
+| `temperature` | float | 否 | 采样温度，默认 0.7 |
+| `max_tokens` | int | 否 | 最大生成 token 数，默认 1024 |
+| `stream` | bool | 否 | 是否流式输出，默认 false |
+| `stop` | string 或 array | 否 | 停止符，**默认无**（直接透传） |
+
+响应结构与 `/v1/chat/completions` 类似，但 `object` 为 `text_completion`，`choices` 中是 `text` 字段而非 `message`。
+
+---
+
+## GET /v1/models
+
+列出已加载的模型。
+
+```json
+{
+  "object": "list",
+  "data": [
+    {"id": "Qwen3.5-9B-Q5_K_M.gguf", "object": "model", "created": 1700000000, "owned_by": "local", "path": "/abs/path/file.gguf"}
+  ]
+}
+```
+
+未加载模型时 `data` 为空数组。
+
+---
+
+## GET /health
+
+健康检查。
+
+```json
+{"status": "ok", "model_loaded": true, "model_path": "/abs/path/file.gguf"}
+```
+
+---
+
+## POST /v1/internal/load
+
+加载模型（GUI 内部使用，也可脚本调用）。
+
+### 请求体
+
+```json
+{
+  "model_path": "/abs/path/Qwen3.5-9B-Q5_K_M.gguf",
+  "n_ctx": 8192,
+  "n_threads": null,
+  "n_gpu_layers": -1
+}
+```
+
+| 字段 | 类型 | 必填 | 说明 |
+|---|---|---|---|
+| `model_path` | string | 是 | .gguf 文件绝对路径 |
+| `n_ctx` | int | 否 | 默认 8192 |
+| `n_threads` | int/null | 否 | 默认 null，由 llama.cpp 自动选择 |
+| `n_gpu_layers` | int | 否 | 默认 -1（全部 GPU） |
+
+成功响应：
+
+```json
+{"status": "loaded", "model_path": "...", "n_ctx": 8192, "n_threads": null, "n_gpu_layers": -1}
+```
+
+加载成功后，参数会自动持久化到 `~/.py3model/config.json`。
+
+---
+
+## POST /v1/internal/unload
+
+卸载当前模型，释放显存/内存。
+
+```json
+{"status": "unloaded"}
+```
+
+---
+
+## 调用示例（OpenAI Python SDK）
+
+```python
+from openai import OpenAI
+
+client = OpenAI(base_url="http://127.0.0.1:11434/v1", api_key="not-needed")
+
+resp = client.chat.completions.create(
+    model="gguf-local",
+    messages=[{"role": "user", "content": "你好"}],
+    stream=True,
+)
+for chunk in resp:
+    if chunk.choices[0].delta.content:
+        print(chunk.choices[0].delta.content, end="", flush=True)
+```
+
+## 调用示例（curl 流式）
+
+```bash
+curl http://127.0.0.1:11434/v1/chat/completions \
+  -H "Content-Type: application/json" \
+  -d '{
+    "model": "gguf-local",
+    "messages": [{"role":"user","content":"你好"}],
+    "stream": true
+  }'

py3model-0.1.0/docs/config.md

@@ -0,0 +1,89 @@
+# 配置文件
+
+配置文件位置：`~/.py3model/config.json`
+
+首次启动会自动创建。也可以手动编辑。
+
+## 字段说明
+
+### 服务相关
+
+| 字段 | 类型 | 默认值 | 说明 |
+|---|---|---|---|
+| `model_path` | string | `""` | 当前加载的 GGUF 模型文件绝对路径 |
+| `host` | string | `"127.0.0.1"` | HTTP 监听地址 |
+| `port` | int | `11434` | HTTP 监听端口 |
+| `temperature` | float | `0.7` | 默认生成温度（生成参数，非模型加载参数） |
+| `max_tokens` | int | `1024` | 默认最大生成 token 数（生成参数，非模型加载参数） |
+
+### llama_cpp.Llama 加载参数
+
+以下字段对应 `llama_cpp.Llama(...)` 构造函数的同名参数，会在加载模型时原样传入。详细解释见 GUI 中每个参数旁的 ⓘ 按钮。
+
+| 字段 | 类型 | 默认值 | 说明 |
+|---|---|---|---|
+| `n_ctx` | int | `8192` | 上下文窗口大小（token 数） |
+| `n_batch` | int | `512` | prompt eval 的逻辑最大批大小 |
+| `n_ubatch` | int | `512` | 物理 micro-batch 大小 |
+| `n_threads` | int/null | `null` | 文本生成的 CPU 线程数；`null`/留空表示自动 |
+| `n_threads_batch` | int/null | `null` | prompt eval 的 CPU 线程数；`null`/留空表示自动 |
+| `n_gpu_layers` | int | `-1` | 卸载到 GPU 的层数；`-1` = 全部 |
+| `use_mmap` | bool | `true` | 使用 mmap 加载模型 |
+| `use_mlock` | bool | `false` | 强制系统把模型常驻内存 |
+| `vocab_only` | bool | `false` | 仅加载词汇表 |
+| `logits_all` | bool | `false` | 返回所有 token 的 logits |
+| `embedding` | bool | `false` | 开启 embedding 模式 |
+| `offload_kqv` | bool | `true` | K/Q/V 张量卸载到 GPU |
+| `flash_attn` | bool | `false` | 启用 Flash Attention |
+| `op_offload` | bool/null | `null` | 操作卸载策略；`null` 表示默认 |
+| `swa_full` | bool/null | `null` | 滑动窗口注意力 KV cache 策略 |
+| `rope_scaling_type` | int | `-1` | RoPE 缩放类型 |
+| `rope_freq_base` | float | `0.0` | RoPE 基础频率（0 = 使用模型自带值） |
+| `rope_freq_scale` | float | `0.0` | RoPE 频率缩放因子 |
+| `yarn_orig_ctx` | int | `0` | YaRN 扩展的原始训练上下文 |
+| `yarn_ext_factor` | float | `-1.0` | YaRN 插值外推因子 |
+| `yarn_attn_factor` | float | `1.0` | YaRN attention 缩放因子 |
+| `yarn_beta_fast` | float | `32.0` | YaRN beta fast 参数 |
+| `yarn_beta_slow` | float | `1.0` | YaRN beta slow 参数 |
+| `type_k` | int/null | `null` | KV cache K 张量 GGML 类型；常见值：1=f16，2=q4_0，8=q8_0 |
+| `type_v` | int/null | `null` | KV cache V 张量 GGML 类型；常见值：1=f16，2=q4_0，8=q8_0 |
+| `last_n_tokens_size` | int | `64` | repeat_penalty 队列大小 |
+| `seed` | int | `4294967295` | 随机种子（4294967295 = 随机） |
+| `split_mode` | int | `1` | 多 GPU 模型拆分模式 |
+| `main_gpu` | int | `0` | 主 GPU 编号 |
+| `pooling_type` | int | `-1` | embedding 池化类型 |
+| `attention_type` | int | `-1` | 注意力类型 |
+| `lora_base` | string/null | `null` | LoRA base 模型路径 |
+| `lora_scale` | float | `1.0` | LoRA 权重缩放系数 |
+| `lora_path` | string/null | `null` | LoRA 适配器路径 |
+| `numa` | bool | `false` | NUMA 优化 |
+| `chat_format` | string/null | `null` | 聊天模板格式 |
+| `spm_infill` | bool | `false` | SentencePiece infill 模式 |
+| `no_perf` | bool | `false` | 禁用性能计时信息 |
+| `verbose` | bool | `false` | 输出 llama.cpp 内部日志 |
+
+## 示例
+
+```json
+{
+  "model_path": "/Users/me/models/Qwen3.5-9B-Q5_K_M.gguf",
+  "n_ctx": 8192,
+  "n_threads": null,
+  "n_gpu_layers": -1,
+  "temperature": 0.7,
+  "max_tokens": 1024,
+  "host": "127.0.0.1",
+  "port": 11434,
+  "use_mmap": true,
+  "offload_kqv": true,
+  "flash_attn": false
+}
+```
+
+## 修改方式
+
+- **GUI**：在窗口「基础参数/高级参数」中调整后，点「保存参数」按钮；点「加载模型」时也会自动保存
+- **手动**：直接编辑文件后下次启动生效
+- **代码**：`from py3model.config import update; update(port=8080, n_ctx=4096)`
+
+> 注：完整参数定义见源码 `src/py3model/gguf/index.py` 中的 `LLAMA_PARAMS` 字典——每个条目包含 `default / kind / desc`（描述会显示在 GUI 的悬浮提示中）。

py3model-0.1.0/docs/install.md

@@ -0,0 +1,50 @@
+# 安装与启动
+
+## 安装
+
+```bash
+pip3 install py3model
+```
+
+依赖只有 `llama-cpp-python`，会在安装时自动拉取（首次安装可能需要几分钟编译）。
+
+## 启动
+
+最简单的启动方式：
+
+```bash
+py3model
+```
+
+执行后：
+1. 命令行会打印 HTTP 服务地址
+2. 弹出 tkinter 可视化窗口
+3. 在窗口中选择本地 `.gguf` 文件并点击「加载模型」即可
+
+## 命令行参数
+
+| 参数 | 说明 | 默认值 |
+|---|---|---|
+| `--port` | HTTP 监听端口 | 11434（或 `~/.py3model/config.json` 中的 `port`）|
+| `--host` | HTTP 监听地址 | `127.0.0.1`（或配置中的 `host`）|
+| `--no-gui` | 不打开 GUI，只跑 HTTP 服务（适合远程/无桌面环境）| — |
+
+```bash
+py3model                          # 默认（读 ~/.py3model/config.json）
+py3model --port 8080              # 指定端口
+py3model --host 0.0.0.0           # 监听所有网卡（允许局域网访问）
+py3model --no-gui                 # 只跑 HTTP 服务，不打开 GUI
+py3model --host 0.0.0.0 --port 8080 --no-gui   # 远程服务器场景
+```
+
+## 系统要求
+
+- Python 3.8+
+- macOS / Linux / Windows 均可
+- 8GB+ 可用内存（取决于模型大小）
+
+## 故障排查
+
+- **端口被占用**：用 `--port` 换一个端口，或在 GUI 启动后查看顶部状态
+- **GGUF 文件无效**：确保文件完整下载且后缀为 `.gguf`
+- **首次加载慢**：`llama-cpp-python` 首次加载模型需要几秒到几十秒

py3model-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

py3model-0.1.0/setup.py

@@ -0,0 +1,43 @@
+#!/usr/bin/python3
+
+from setuptools import setup, find_packages
+
+readmeFile = open("README.md", "r", encoding="utf-8")
+long_description = readmeFile.read().replace(
+    "./docs/", "https://github.com/aihatch/py3model/blob/master/docs/"
+)
+readmeFile.close()
+
+# https://setuptools.pypa.io/en/latest/setuptools.html
+
+setup(
+    name="py3model",
+    version="0.1.0",
+    description="提供python3版本的本地模型文件运行脚本或命令",
+    long_description=long_description,
+    long_description_content_type="text/markdown",
+    author="zxl20070701",
+    author_email="1904314465@qq.com",
+    maintainer="zxl20070701",
+    maintainer_email="1904314465@qq.com",
+    package_dir={"": "src"},
+    packages=find_packages(where="src"),
+    url="https://github.com/aihatch/py3model",
+    license="MIT",
+    keywords=["gguf","model", "python3"],
+    classifiers=[
+        "Programming Language :: Python :: 3",
+        "License :: OSI Approved :: MIT License",
+        "Operating System :: OS Independent",
+    ],
+    install_requires=[
+        "llama-cpp-python==0.3.23"
+    ],
+    entry_points={
+        "console_scripts": [
+            # 命令名 = 模块路径:函数名，不要加括号！
+            # 开发模式安装：pip3 install -e .
+            "py3model = py3model.cli:main",
+        ]
+    }
+)

py3model-0.1.0/src/py3model/__init__.py

@@ -0,0 +1 @@
+#!/usr/bin/python3

py3model-0.1.0/src/py3model/cli.py

@@ -0,0 +1,89 @@
+#!/usr/bin/python3
+# coding=utf-8
+
+"""
+py3model 命令行入口。
+
+执行 `py3model` 时：
+  1. 解析命令行参数（端口、host 等）
+  2. 启动 HTTP 服务（后台线程）
+  3. 启动 tkinter GUI（主线程阻塞）
+  4. GUI 关闭 -> 关闭后台服务 -> 退出
+
+用法：
+    py3model                       # 使用默认配置
+    py3model --port 8080           # 修改端口
+    py3model --host 0.0.0.0        # 监听所有网卡
+"""
+
+import argparse
+import sys
+
+from .config import load as cfg_load
+from .server import start as server_start, stop as server_stop, is_running
+from .gui import run as gui_run
+
+
+def _parse_args() -> argparse.Namespace:
+    parser = argparse.ArgumentParser(
+        prog="py3model",
+        description="本地启动 GGUF 模型文件，并提供 OpenAI 兼容的 HTTP 服务。",
+    )
+    parser.add_argument("--host", help="HTTP 监听地址（默认读取 ~/.py3model/config.json）")
+    parser.add_argument("--port", type=int, help="HTTP 监听端口（默认 11434）")
+    parser.add_argument(
+        "--no-gui",
+        action="store_true",
+        help="不启动 GUI，只在后台运行 HTTP 服务（适合无桌面/远程服务器场景）",
+    )
+    return parser.parse_args()
+
+
+def main() -> int:
+    args = _parse_args()
+    cfg = cfg_load()
+
+    host = args.host or cfg.get("host", "127.0.0.1")
+    port = args.port or int(cfg.get("port", 11434))
+
+    # 启动 HTTP 服务
+    thread, server = server_start(host=host, port=port)
+    if server is None:
+        print(
+            f"[py3model] HTTP 服务启动失败：{host}:{port} 可能已被占用。\n"
+            f"          可用 --port 修改端口，或关闭占用进程后重试。",
+            file=sys.stderr,
+        )
+        if args.no_gui:
+            return 1
+        # 即便端口被占用，仍然打开 GUI，让用户看到状态、调整后再启动
+        print("[py3model] 将继续打开 GUI，你可以更换端口后重试。", file=sys.stderr)
+
+    if is_running():
+        print(f"[py3model] HTTP 服务已启动：http://{host}:{port}")
+        print(f"[py3model] OpenAI 兼容 base_url：http://{host}:{port}/v1")
+
+    # GUI（主线程）
+    if args.no_gui:
+        try:
+            # 无 GUI 模式：阻塞主线程直到 Ctrl+C
+            import time
+            print("[py3model] 无 GUI 模式，Ctrl+C 退出。")
+            while True:
+                time.sleep(1)
+        except KeyboardInterrupt:
+            print("\n[py3model] 收到中断信号，正在关闭…")
+        finally:
+            server_stop()
+        return 0
+
+    # 默认：打开 GUI（GUI 关闭时会自动调用 server.stop）
+    try:
+        gui_run()
+    except KeyboardInterrupt:
+        server_stop()
+    return 0
+
+
+if __name__ == "__main__":
+    sys.exit(main())

py3model-0.1.0/src/py3model/config/__init__.py

@@ -0,0 +1,2 @@
+#!/usr/bin/python3
+from .index import load, save, update, reset, config_dir, config_path