pythonclaw 0.2.0__py3-none-any.whl

pythonclaw/templates/skills/system/time/time_util.py

@@ -0,0 +1,81 @@
+#!/usr/bin/env python3
+"""Get current time, convert between timezones."""
+
+import argparse
+from datetime import datetime, timezone, timedelta
+import json
+
+COMMON_TIMEZONES = {
+    "UTC": 0, "US/Eastern": -5, "US/Central": -6, "US/Mountain": -7,
+    "US/Pacific": -8, "Europe/London": 0, "Europe/Paris": 1,
+    "Europe/Berlin": 1, "Asia/Tokyo": 9, "Asia/Shanghai": 8,
+    "Asia/Singapore": 8, "Asia/Kolkata": 5.5, "Australia/Sydney": 11,
+    "America/New_York": -5, "America/Chicago": -6,
+    "America/Los_Angeles": -8, "America/Sao_Paulo": -3,
+}
+
+
+def _tz_offset(name: str) -> timezone:
+    name_lower = name.lower().replace(" ", "_")
+    for k, v in COMMON_TIMEZONES.items():
+        if k.lower() == name_lower:
+            return timezone(timedelta(hours=v))
+    try:
+        hours = float(name)
+        return timezone(timedelta(hours=hours))
+    except ValueError:
+        pass
+    raise ValueError(f"Unknown timezone: {name}. Use --list-tz to see options.")
+
+
+def main():
+    parser = argparse.ArgumentParser(description="Time utility")
+    parser.add_argument("--tz", type=str, help="Show time in this timezone")
+    parser.add_argument("--list-tz", action="store_true", help="List common timezones")
+    parser.add_argument("--unix", action="store_true", help="Show Unix timestamp")
+    parser.add_argument("--convert", type=str, help="Datetime string to convert")
+    parser.add_argument("--from-tz", type=str, help="Source timezone for conversion")
+    parser.add_argument("--to-tz", type=str, help="Target timezone for conversion")
+    args = parser.parse_args()
+
+    if args.list_tz:
+        for name, offset in sorted(COMMON_TIMEZONES.items()):
+            sign = "+" if offset >= 0 else ""
+            print(f"  {name:25s} UTC{sign}{offset}")
+        return
+
+    if args.unix:
+        print(int(datetime.now(timezone.utc).timestamp()))
+        return
+
+    if args.convert:
+        if not args.from_tz or not args.to_tz:
+            print("Error: --convert requires --from-tz and --to-tz")
+            return
+        src_tz = _tz_offset(args.from_tz)
+        dst_tz = _tz_offset(args.to_tz)
+        dt = datetime.strptime(args.convert, "%Y-%m-%d %H:%M").replace(tzinfo=src_tz)
+        converted = dt.astimezone(dst_tz)
+        print(json.dumps({
+            "from": f"{args.convert} ({args.from_tz})",
+            "to": converted.strftime("%Y-%m-%d %H:%M:%S %Z") + f" ({args.to_tz})",
+        }, indent=2))
+        return
+
+    if args.tz:
+        tz = _tz_offset(args.tz)
+        now = datetime.now(tz)
+    else:
+        now = datetime.now()
+
+    print(json.dumps({
+        "datetime": now.strftime("%Y-%m-%d %H:%M:%S"),
+        "date": now.strftime("%Y-%m-%d"),
+        "time": now.strftime("%H:%M:%S"),
+        "weekday": now.strftime("%A"),
+        "timezone": args.tz or "local",
+    }, indent=2))
+
+
+if __name__ == "__main__":
+    main()

pythonclaw/templates/skills/text/CATEGORY.md

@@ -0,0 +1,4 @@
+---
+name: text
+description: Skills for text manipulation including counting characters, reversing strings, and changing case.
+---

pythonclaw/templates/skills/text/translator/SKILL.md

@@ -0,0 +1,47 @@
+---
+name: translator
+description: >
+  Translate text between any languages. Supports 100+ languages with
+  automatic source language detection. Use when the user asks to
+  translate text, detect a language, or work with multilingual content.
+---
+
+## Instructions
+
+Translate text between languages using the `deep-translator` library.
+Supports 100+ languages with automatic detection of the source language.
+
+### Prerequisites
+
+Install dependency: `pip install deep-translator`
+
+### Usage
+
+```bash
+python {skill_path}/translate.py "text to translate" --to TARGET_LANG [options]
+```
+
+Options:
+- `--to LANG` — target language code or name (required, e.g. `zh-CN`, `french`, `ja`)
+- `--from LANG` — source language (default: `auto` for auto-detection)
+- `--format json` — output as JSON
+
+### Language Codes
+
+Common codes: `en` (English), `zh-CN` (Chinese Simplified), `zh-TW` (Chinese Traditional),
+`ja` (Japanese), `ko` (Korean), `fr` (French), `de` (German), `es` (Spanish),
+`pt` (Portuguese), `ru` (Russian), `ar` (Arabic), `hi` (Hindi), `it` (Italian).
+
+You can also use full names: `chinese (simplified)`, `japanese`, `french`, etc.
+
+### Examples
+
+- "Translate 'Hello world' to Chinese" → `python {skill_path}/translate.py "Hello world" --to zh-CN`
+- "Translate this Japanese text to English" → `python {skill_path}/translate.py "..." --from ja --to en`
+- "How do you say 'thank you' in Korean?" → `python {skill_path}/translate.py "thank you" --to ko`
+
+## Resources
+
+| File | Description |
+|------|-------------|
+| `translate.py` | Multi-language translator |

pythonclaw/templates/skills/text/translator/translate.py

@@ -0,0 +1,66 @@
+#!/usr/bin/env python3
+"""Translate text between languages using deep-translator."""
+
+import argparse
+import json
+import sys
+
+try:
+    from deep_translator import GoogleTranslator
+except ImportError:
+    print("Error: deep-translator not installed.  Run: pip install deep-translator",
+          file=sys.stderr)
+    sys.exit(1)
+
+
+def translate(text: str, target: str, source: str = "auto") -> dict:
+    translator = GoogleTranslator(source=source, target=target)
+    result = translator.translate(text)
+    return {
+        "source_lang": source,
+        "target_lang": target,
+        "original": text,
+        "translated": result,
+    }
+
+
+def list_languages() -> dict:
+    return GoogleTranslator().get_supported_languages(as_dict=True)
+
+
+def main():
+    parser = argparse.ArgumentParser(description="Translate text between languages.")
+    parser.add_argument("text", nargs="?", help="Text to translate")
+    parser.add_argument("--to", dest="target", default="en", help="Target language")
+    parser.add_argument("--from", dest="source", default="auto", help="Source language (auto)")
+    parser.add_argument("--format", choices=["text", "json"], default="text")
+    parser.add_argument("--list-languages", action="store_true",
+                        help="List all supported languages")
+    args = parser.parse_args()
+
+    if args.list_languages:
+        langs = list_languages()
+        if args.format == "json":
+            print(json.dumps(langs, indent=2, ensure_ascii=False))
+        else:
+            for name, code in sorted(langs.items()):
+                print(f"  {code:10s} {name}")
+        return
+
+    if not args.text:
+        parser.error("Please provide text to translate.")
+
+    try:
+        result = translate(args.text, target=args.target, source=args.source)
+    except Exception as exc:
+        print(f"Translation error: {exc}", file=sys.stderr)
+        sys.exit(1)
+
+    if args.format == "json":
+        print(json.dumps(result, indent=2, ensure_ascii=False))
+    else:
+        print(f"{result['translated']}")
+
+
+if __name__ == "__main__":
+    main()

pythonclaw/templates/skills/web/CATEGORY.md

@@ -0,0 +1,4 @@
+---
+name: web
+description: Skills for web searching, data retrieval, and online information gathering.
+---

pythonclaw/templates/skills/web/tavily/SKILL.md

@@ -0,0 +1,61 @@
+---
+name: tavily_search
+description: >
+  Advanced web search using the Tavily API. Use when the user asks to search
+  the web, look up current events, find real-time information, research a topic,
+  check facts, or retrieve data from the internet.
+---
+# Tavily Web Search
+
+## Overview
+
+You have a built-in `web_search` tool powered by [Tavily](https://tavily.com).
+It provides real-time web search with AI-generated summaries and source links.
+
+## Instructions
+
+Use the `web_search` tool directly — no external scripts needed.
+
+### Parameters
+
+| Parameter | Type | Description | Default |
+|-----------|------|-------------|---------|
+| `query` | string | The search query (be specific) | **required** |
+| `search_depth` | string | `"basic"` (fast) or `"advanced"` (thorough) | `"basic"` |
+| `topic` | string | `"general"`, `"news"`, or `"finance"` | `"general"` |
+| `max_results` | integer | Number of results (1-20) | `5` |
+| `time_range` | string | `"day"`, `"week"`, `"month"`, or `"year"` | none |
+
+### Examples
+
+**Basic search:**
+```
+web_search(query="Python 3.13 new features")
+```
+
+**News search (last week):**
+```
+web_search(query="AI industry news", topic="news", time_range="week", max_results=10)
+```
+
+**Finance search (advanced depth):**
+```
+web_search(query="NVIDIA stock analysis 2026", topic="finance", search_depth="advanced")
+```
+
+## Best Practices
+
+1. **Be specific** — "Python asyncio best practices 2026" is better than "Python async"
+2. **Use `topic`** — set `"news"` for current events, `"finance"` for market data
+3. **Use `time_range`** — filter by `"day"` or `"week"` when freshness matters
+4. **Use `advanced`** — set `search_depth="advanced"` for research-heavy queries
+5. **Cite sources** — always include the URLs returned in your response to the user
+
+## Setup
+
+1. Get a free API key at [app.tavily.com](https://app.tavily.com/home)
+2. Add your key to `pythonclaw.json`:
+   ```json5
+   "tavily": { "apiKey": "tvly-..." }
+   ```
+3. Install the SDK: `pip install tavily-python`

pythonclaw/templates/soul/SOUL.md

@@ -0,0 +1,54 @@
+# PythonClaw — Soul
+
+You are a PythonClaw agent — an autonomous AI assistant.
+
+This document defines your core identity — the values, principles, and character
+that remain constant regardless of which persona or role you are playing.
+
+## Core Values
+
+- **Honesty**: You never fabricate facts. When you are uncertain, you say so
+  clearly. You distinguish between what you know, what you believe, and what
+  you are guessing.
+
+- **Helpfulness**: Your primary purpose is to genuinely help the people you
+  work with. You look for the real need behind a request, not just the literal
+  wording.
+
+- **Respect**: You treat every person with dignity. You do not belittle, mock,
+  or dismiss. You adapt your communication style to the person, not the other
+  way around.
+
+- **Curiosity**: You are genuinely interested in problems. You ask clarifying
+  questions when needed and enjoy understanding things deeply before acting.
+
+- **Responsibility**: You think before you act. You consider side-effects, warn
+  about risks, and prefer reversible actions over irreversible ones.
+
+## Ethical Boundaries
+
+- You will not help with anything that could cause serious harm to people or
+  systems.
+- You will not deceive or manipulate.
+- You will not generate content that demeans or endangers individuals or groups.
+- If asked to do something that conflicts with these principles you explain why
+  you cannot, and offer a constructive alternative when possible.
+
+## Emotional Character
+
+You are calm and steady, even when conversations become tense or unclear.
+You do not perform enthusiasm you do not feel, but you are warm and
+encouraging when genuine encouragement is warranted.
+You acknowledge your own limitations without defensiveness.
+
+## Relationship with the User
+
+You remember that the person you are talking with has a life, goals, and
+context beyond this conversation. You treat their time as valuable. You keep
+responses as concise as the situation allows, expanding only when depth is
+genuinely needed.
+
+---
+*This soul file is loaded at agent startup and cannot be overridden by persona
+files, skills, or user instructions. It is the foundation everything else is
+built upon.*

pythonclaw/web/__init__.py

@@ -0,0 +1 @@
+"""PythonClaw Web Dashboard — localhost UI for config, chat, and skill browsing."""