From 7337ca205bcbd19a28f7c7a85de5190e1f45f0ec Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=E7=84=B6=E8=80=8C?= Date: Tue, 21 Apr 2026 11:18:58 +0800 Subject: [PATCH 1/5] docs(compliance): add non-affiliation and trademark notice --- README.md | 13 ++++++------- 1 file changed, 6 insertions(+), 7 deletions(-) diff --git a/README.md b/README.md index 576811f24..9f3995990 100644 --- a/README.md +++ b/README.md @@ -1,11 +1,5 @@ # howeverpipecat - 实时语音智能体工程分发版 | Real-time Voice Agent Distribution -> **非官方声明（Non-Affiliation）** -> 本仓库为社区维护的衍生/二次开发版本，与上游项目及其权利主体不存在官方关联、授权背书或从属关系。 -> **商标声明（Trademark Notice）** -> 相关项目名称、Logo 与商标归其各自权利人所有。本仓库仅用于说明兼容/来源，不主张任何商标权利。 - -

howeverpipecat logo

@@ -19,6 +13,11 @@ [![License](https://img.shields.io/badge/License-BSD--2--Clause-16A34A)](./LICENSE) [![Repository](https://img.shields.io/badge/Repo-however--yir%2Fhoweverpipecat-0EA5E9)](https://github.com/however-yir/howeverpipecat) +> **非官方声明（Non-Affiliation）**
+> `howeverpipecat` 是基于 `pipecat-ai/pipecat` 的社区维护衍生发行版，与上游项目及其权利主体不存在官方关联、授权背书或从属关系。
+> **商标声明（Trademark Notice）**
+> `Pipecat` 及相关项目名称、Logo 与商标归其各自权利人所有；本仓库仅用于说明上游来源与兼容关系。 + --- ## 目录 @@ -358,4 +357,4 @@ bash scripts/however_dependency_security_scan.sh - Upstream 许可证：`LICENSE`（BSD-2-Clause） - Fork 补充说明：`LICENSE.HOWEVER` -本仓用于工程开发、测试和部署实践。生产使用前，请自行完成安全、合规与稳定性评估。 \ No newline at end of file +本仓用于工程开发、测试和部署实践。生产使用前，请自行完成安全、合规与稳定性评估。 From af50b507cc018f72c61ee3781b9b115cb91e2739 Mon Sep 17 00:00:00 2001 From: however Date: Tue, 21 Apr 2026 13:13:45 +0800 Subject: [PATCH 2/5] style: apply ruff formatting for quality check --- src/pipecat/services/ollama/llm.py | 4 +--- src/pipecat/utils/however_health.py | 22 +++++++++++++++++++--- 2 files changed, 20 insertions(+), 6 deletions(-) diff --git a/src/pipecat/services/ollama/llm.py b/src/pipecat/services/ollama/llm.py index 11ef2114c..424f72cb1 100644 --- a/src/pipecat/services/ollama/llm.py +++ b/src/pipecat/services/ollama/llm.py @@ -77,9 +77,7 @@ def __init__( default_settings.apply_update(settings) resolved_base_url = ( - base_url - or os.getenv("PIPECAT_OLLAMA_BASE_URL") - or "http://127.0.0.1:11434/v1" + base_url or os.getenv("PIPECAT_OLLAMA_BASE_URL") or "http://127.0.0.1:11434/v1" ) super().__init__( base_url=resolved_base_url, diff --git a/src/pipecat/utils/however_health.py b/src/pipecat/utils/however_health.py index 1c8da71d3..0e32b4ae7 100644 --- a/src/pipecat/utils/however_health.py +++ b/src/pipecat/utils/however_health.py @@ -39,7 +39,11 @@ def _fault_type_from_error(name: str, detail: str) -> str: lowered = detail.lower() if "401" in lowered or "403" in lowered or "unauthorized" in lowered or "forbidden" in lowered: return "auth_error" - if "connection refused" in lowered or "timed out" in lowered or "name or service not known" in lowered: + if ( + "connection refused" in lowered + or "timed out" in lowered + or "name or service not known" in lowered + ): return "network_error" if "invalid" in lowered or "must use one of" in lowered: return "config_error" @@ -53,7 +57,13 @@ def _check_tcp(name: str, host: str, port: int, timeout_s: float) -> CheckResult try: with socket.create_connection((host, port), timeout=timeout_s): latency = int((time.monotonic() - start) * 1000) - return CheckResult(name=name, status="ok", detail=f"connected {host}:{port}", latency_ms=latency, fault_type="none") + return CheckResult( + name=name, + status="ok", + detail=f"connected {host}:{port}", + latency_ms=latency, + fault_type="none", + ) except OSError as exc: latency = int((time.monotonic() - start) * 1000) detail = f"{host}:{port} - {exc}" @@ -73,7 +83,13 @@ def _check_http(name: str, url: str, timeout_s: float) -> CheckResult: with urlopen(req, timeout=timeout_s) as resp: latency = int((time.monotonic() - start) * 1000) if 200 <= resp.status < 400: - return CheckResult(name=name, status="ok", detail=f"http {resp.status} {url}", latency_ms=latency, fault_type="none") + return CheckResult( + name=name, + status="ok", + detail=f"http {resp.status} {url}", + latency_ms=latency, + fault_type="none", + ) detail = f"http {resp.status} {url}" return CheckResult( name=name, From a4c5c9064028670511c0119bc757a4d99995d666 Mon Sep 17 00:00:00 2001 From: however Date: Tue, 21 Apr 2026 13:29:26 +0800 Subject: [PATCH 3/5] style: satisfy ruff import and docstring checks --- scripts/however_naming_lint.py | 2 +- scripts/however_service_health.py | 2 +- src/pipecat/__init__.py | 3 +-- src/pipecat/services/ollama/llm.py | 5 +++-- src/pipecat/utils/however_health.py | 9 +++++++-- src/pipecat/utils/however_runtime_config.py | 5 +++-- 6 files changed, 16 insertions(+), 10 deletions(-) diff --git a/scripts/however_naming_lint.py b/scripts/however_naming_lint.py index 07cc255e8..fee363c93 100755 --- a/scripts/however_naming_lint.py +++ b/scripts/however_naming_lint.py @@ -9,9 +9,9 @@ from __future__ import annotations -from pathlib import Path import re import sys +from pathlib import Path ROOT = Path(__file__).resolve().parents[1] diff --git a/scripts/however_service_health.py b/scripts/however_service_health.py index a9d4362cc..d0cef614d 100755 --- a/scripts/however_service_health.py +++ b/scripts/however_service_health.py @@ -11,8 +11,8 @@ import argparse import json -from pathlib import Path import sys +from pathlib import Path try: from pipecat.utils.however_health import build_however_health_result diff --git a/src/pipecat/__init__.py b/src/pipecat/__init__.py index f4cb33ea7..02dc46b3e 100644 --- a/src/pipecat/__init__.py +++ b/src/pipecat/__init__.py @@ -4,6 +4,7 @@ # SPDX-License-Identifier: BSD 2-Clause License # +import asyncio import sys from importlib.metadata import PackageNotFoundError, version as lib_version @@ -38,8 +39,6 @@ def version() -> str: # # See https://github.com/python/cpython/pull/98518 -import asyncio - if sys.version_info < (3, 12): import wait_for2 diff --git a/src/pipecat/services/ollama/llm.py b/src/pipecat/services/ollama/llm.py index 424f72cb1..0f5603b4c 100644 --- a/src/pipecat/services/ollama/llm.py +++ b/src/pipecat/services/ollama/llm.py @@ -6,10 +6,10 @@ """Ollama LLM service implementation for the Pipecat framework.""" -from dataclasses import dataclass import os -from typing import Optional import warnings +from dataclasses import dataclass +from typing import Optional from loguru import logger @@ -104,6 +104,7 @@ class OLLamaLLMService(OllamaLLMService): """Deprecated alias for :class:`OllamaLLMService`.""" def __init__(self, *args, **kwargs): + """Initialize legacy alias and emit a deprecation warning.""" warnings.warn( "OLLamaLLMService is deprecated; use OllamaLLMService instead.", DeprecationWarning, diff --git a/src/pipecat/utils/however_health.py b/src/pipecat/utils/however_health.py index 0e32b4ae7..75b9aa762 100644 --- a/src/pipecat/utils/however_health.py +++ b/src/pipecat/utils/however_health.py @@ -8,17 +8,19 @@ from __future__ import annotations +import socket +import time from dataclasses import asdict, dataclass from urllib.parse import urlparse from urllib.request import Request, urlopen -import socket -import time from pipecat.utils.however_runtime_config import HoweverRuntimeConfig, load_however_runtime_config @dataclass(frozen=True) class CheckResult: + """Represents the outcome of an individual dependency health check.""" + name: str status: str detail: str @@ -27,6 +29,7 @@ class CheckResult: @property def ok(self) -> bool: + """Return ``True`` when the check status is successful.""" return self.status == "ok" @@ -115,6 +118,7 @@ def run_however_checks( *, skip_network: bool = False, ) -> tuple[dict[str, object], list[CheckResult]]: + """Run service dependency checks and return metadata plus detailed check results.""" resolved_cfg = cfg or load_however_runtime_config() if skip_network: checks = [ @@ -148,6 +152,7 @@ def build_however_health_result( *, skip_network: bool = False, ) -> dict[str, object]: + """Build a JSON-serializable health report for however runtime dependencies.""" meta, checks = run_however_checks(cfg, skip_network=skip_network) all_ok = all(item.ok for item in checks) result = { diff --git a/src/pipecat/utils/however_runtime_config.py b/src/pipecat/utils/however_runtime_config.py index 276671fd8..4601f8ee8 100644 --- a/src/pipecat/utils/however_runtime_config.py +++ b/src/pipecat/utils/however_runtime_config.py @@ -8,11 +8,11 @@ from __future__ import annotations +import os from dataclasses import dataclass from pathlib import Path from typing import Mapping from urllib.parse import urlparse -import os def _parse_env_file(path: Path) -> dict[str, str]: @@ -59,6 +59,8 @@ def _pick( @dataclass(frozen=True) class HoweverRuntimeConfig: + """Normalized runtime configuration for however Pipecat services.""" + env: str region: str db_url: str @@ -74,7 +76,6 @@ def load_however_runtime_config( environ: Mapping[str, str] | None = None, ) -> HoweverRuntimeConfig: """Load local deployment config from env and optional env file.""" - path_env = Path(env_path) file_env = _parse_env_file(path_env) env_vars = dict(os.environ if environ is None else environ) From f1e9e79a101be75961fd5780523c6344d4a13749 Mon Sep 17 00:00:00 2001 From: however Date: Tue, 21 Apr 2026 13:32:25 +0800 Subject: [PATCH 4/5] style: reorder imports for ruff isort rules --- scripts/however_naming_lint.py | 2 +- src/pipecat/__init__.py | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/scripts/however_naming_lint.py b/scripts/however_naming_lint.py index fee363c93..07cc255e8 100755 --- a/scripts/however_naming_lint.py +++ b/scripts/however_naming_lint.py @@ -9,9 +9,9 @@ from __future__ import annotations +from pathlib import Path import re import sys -from pathlib import Path ROOT = Path(__file__).resolve().parents[1] diff --git a/src/pipecat/__init__.py b/src/pipecat/__init__.py index 02dc46b3e..1d872b27c 100644 --- a/src/pipecat/__init__.py +++ b/src/pipecat/__init__.py @@ -5,8 +5,8 @@ # import asyncio -import sys from importlib.metadata import PackageNotFoundError, version as lib_version +import sys from loguru import logger From cd175a45fb7f1c8441a023ec72093b22ad9683e9 Mon Sep 17 00:00:00 2001 From: however Date: Tue, 21 Apr 2026 13:38:57 +0800 Subject: [PATCH 5/5] style: apply ruff import normalization --- scripts/however_naming_lint.py | 3 +-- src/pipecat/__init__.py | 3 ++- 2 files changed, 3 insertions(+), 3 deletions(-) diff --git a/scripts/however_naming_lint.py b/scripts/however_naming_lint.py index 07cc255e8..da726ec20 100755 --- a/scripts/however_naming_lint.py +++ b/scripts/however_naming_lint.py @@ -9,10 +9,9 @@ from __future__ import annotations -from pathlib import Path import re import sys - +from pathlib import Path ROOT = Path(__file__).resolve().parents[1] diff --git a/src/pipecat/__init__.py b/src/pipecat/__init__.py index 1d872b27c..f45e453a8 100644 --- a/src/pipecat/__init__.py +++ b/src/pipecat/__init__.py @@ -5,8 +5,9 @@ # import asyncio -from importlib.metadata import PackageNotFoundError, version as lib_version import sys +from importlib.metadata import PackageNotFoundError +from importlib.metadata import version as lib_version from loguru import logger