In this tutorial, we implement a QwenPaw workflow that provides a practical environment for building and testing an agent-powered assistant. We install and initialize QwenPaw, configure its working directory, set up authentication, connect optional model providers via Colab secrets, and create a structured workspace with custom skills and local knowledge files. We also launch the QwenPaw Console via a Colab-accessible URL, expose it through an optional Cloudflare tunnel, and test the streaming chat API programmatically, enabling us to use QwenPaw both as an interactive assistant and as an API-driven agent framework.

Copy CodeCopiedUse a different Browser

import os import sys import json import time import uuid import shlex import signal import shutil import socket import secrets import pathlib import subprocess from datetime import datetime RESET_QWENPAW = False PORT = int(os.environ.get("QWENPAW_COLAB_PORT", "8088")) ROOT = pathlib.Path("/content/qwenpaw_colab") WORKING_DIR = ROOT / "working" SECRET_DIR = ROOT / "secrets" LOG_DIR = ROOT / "logs" WORKSPACE_DIR = WORKING_DIR / "workspaces" / "default" PID_FILE = ROOT / "qwenpaw_app.pid" APP_LOG = LOG_DIR / "qwenpaw_app.log" if RESET_QWENPAW and ROOT.exists(): shutil.rmtree(ROOT) for p in [ROOT, WORKING_DIR, SECRET_DIR, LOG_DIR, WORKSPACE_DIR]: p.mkdir(parents=True, exist_ok=True) os.environ["QWENPAW_WORKING_DIR"] = str(WORKING_DIR) os.environ["QWENPAW_SECRET_DIR"] = str(SECRET_DIR) os.environ["QWENPAW_AUTH_ENABLED"] = "true" os.environ["QWENPAW_AUTH_USERNAME"] = os.environ.get("QWENPAW_AUTH_USERNAME", "admin") os.environ["QWENPAW_LOG_LEVEL"] = os.environ.get("QWENPAW_LOG_LEVEL", "info") os.environ["QWENPAW_SKILL_SCAN_MODE"] = os.environ.get("QWENPAW_SKILL_SCAN_MODE", "warn") os.environ["QWENPAW_TOOL_GUARD_ENABLED"] = os.environ.get("QWENPAW_TOOL_GUARD_ENABLED", "true") password_file = SECRET_DIR / ".colab_ui_password" if not password_file.exists(): password_file.write_text("qpw-" + secrets.token_urlsafe(18), encoding="utf-8") os.environ["QWENPAW_AUTH_PASSWORD"] = password_file.read_text(encoding="utf-8").strip() def run(cmd, check=False, env=None, cwd=None, stream=False): if isinstance(cmd, str): display_cmd = cmd shell = True else: display_cmd = " ".join(shlex.quote(str(x)) for x in cmd) shell = False print(f"\n$ {display_cmd}") if stream: proc = subprocess.Popen(cmd, shell=shell, env=env, cwd=cwd, text=True) rc = proc.wait() if check and rc != 0: raise RuntimeError(f"Command failed with exit code {rc}: {display_cmd}") return rc, "" out = subprocess.run( cmd, shell=shell, env=env, cwd=cwd, text=True, stdout=subprocess.PIPE, stderr=subprocess.STDOUT, ) print(out.stdout[-4000:]) if check and out.returncode != 0: raise RuntimeError(f"Command failed with exit code {out.returncode}: {display_cmd}") return out.returncode, out.stdout def port_open(host="127.0.0.1", port=8088, timeout=0.5): try: with socket.create_connection((host, port), timeout=timeout): return True except OSError: return False def wait_for_port(port, seconds=90): start = time.time() while time.time() - start = (3, 10), "QwenPaw needs Python 3.10+." pip_spec = os.environ.get("QWENPAW_PIP_SPEC", "qwenpaw") run([sys.executable, "-m", "pip", "install", "-q", "-U", "pip", "setuptools", "wheel"], check=False) run([sys.executable, "-m", "pip", "install", "-q", "-U", pip_spec, "requests"], check=True) try: import requests except Exception: run([sys.executable, "-m", "pip", "install", "-q", "-U", "requests"], check=True) import requests