Skip to main content

Padwan CLI

Interactive CLI/TUI for padwan-ai.

Chat demo

Quick start

export OPENAI_API_KEY=...
uvx padwan-cli
# then /help for commands

Install

pip install padwan-cli

Local Development

uv sync --group dev
uv run padwan-cli

One-shot Mode

uvx padwan-cli "Hello" -m gpt-4o-mini

# attach files (images/audio/text, routed by type)
uvx padwan-cli "What's in this recording?" -m gpt-4o-audio-preview -f clip.mp3

Voice Mode

Real-time speech-to-speech chat (needs the PortAudio system lib, e.g. libportaudio2):

uvx --from "padwan-cli[voice]" padwan-talk

Tracing

Pass --trace <backend> (on the one-shot, chat send, and talk commands) to instrument all LLM calls with padwan-ai's OTel GenAI telemetry:

# Langfuse, using the standard LANGFUSE_* env vars
export LANGFUSE_PUBLIC_KEY=... LANGFUSE_SECRET_KEY=... LANGFUSE_BASE_URL=...
uvx --from "padwan-cli[langfuse]" padwan-cli "Hello" --trace langfuse

# any OTLP collector, using the standard OTEL_EXPORTER_OTLP_* env vars
OTEL_EXPORTER_OTLP_ENDPOINT=http://localhost:4318 \
  uvx --from "padwan-cli[otel]" padwan-cli "Hello" --trace otlp

Metadata

Release files for padwan-cli 0.6.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for padwan-cli 0.6.1
File Size Uploaded
padwan_cli-0.6.1.tar.gz 22.9 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for padwan-cli 0.6.1
File Interpreter ABI Platform
padwan_cli-0.6.1-py3-none-any.whl Python 3 none any Details

Total release size: 49.9 kB

Release files / padwan_cli-0.6.1.tar.gz

Download URL padwan_cli-0.6.1.tar.gz
Size 22.9 kB
Tags Source
SHA-256 checksum
How to use checksums
746e398f542843f49e5869c6326ec76afe72365eadac673b38a7c861a22ae8f3
BLAKE2b-256 checksum
How to use checksums
2a13ec776280b06bf89d3b6732b24a0e09d378de3f7ce3f5f05bbda921777b9d
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via uv/0.13.0 {"installer":{"name":"uv","version":"0.13.0","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

Release files / padwan_cli-0.6.1-py3-none-any.whl

Download URL padwan_cli-0.6.1-py3-none-any.whl
Size 27.0 kB
Tags Python 3
SHA-256 checksum
How to use checksums
f14557ac305a03d155807c02b65486730eda689b7c932a6097e8320b5c3fce85
BLAKE2b-256 checksum
How to use checksums
fe0d505632f43ae3e18e1d8cefb76d9f65cb6bb76f71698ebfb32629af79c845
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via uv/0.13.0 {"installer":{"name":"uv","version":"0.13.0","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

Release history Release notifications | RSS feed

This release

0.6.1 This release

2 release files

0.6.0

2 release files

0.5.0

2 release files

0.4.0

2 release files

0.3.0

2 release files

0.2.3

2 release files

0.2.2

2 release files

0.2.1

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page