programasweights 0.2.1__tar.gz → 0.2.2.dev1__tar.gz

programasweights-0.2.2.dev1/.cursor/rules/sdk-publishing.mdc

@@ -0,0 +1,53 @@
+---
+description: SDK publishing workflow for Python and JavaScript packages
+alwaysApply: true
+---
+
+# SDK Publishing Rules
+
+## Public repos are the source of truth for published packages
+
+- **Python SDK**: https://github.com/programasweights/programasweights-python
+- **JS SDK**: https://github.com/programasweights/programasweights-js
+
+## Release workflow
+
+1. Make changes in the public repo (feature branch -> PR -> main)
+2. Bump version in `pyproject.toml` / `__init__.py` (Python) or `package.json` (JS)
+3. Run tests: `bash tests/test_sdk.sh` (Python) or `npm test && npx playwright test` (JS)
+4. Tag: `git tag -a vX.Y.Z -m "Release vX.Y.Z"`
+5. Build and publish from the tagged commit:
+   - Python: `python -m build && twine upload dist/*`
+   - JS: `npm publish --access public`
+6. Push tag: `git push origin vX.Y.Z`
+7. Verify: compare published package with repo (`pip download` / `npm pack` then diff)
+
+## Never do
+
+- Do NOT publish from the monorepo (`paw_discrete/programasweights/`) -- always use the public repos
+- Do NOT publish without tagging first
+- Do NOT forget to sync the monorepo after publishing (if changes originated there)
+- Do NOT use rsync/scp for code deployment -- always git push + git pull
+- Do NOT deploy to server without committing to git first
+
+## All repos are under github.com/programasweights/
+
+- `website` -- monorepo deployed to server (git push website main)
+- `programasweights-python` -- Python SDK (published to PyPI)
+- `programasweights-js` -- JS SDK (published to npm)
+
+## Wheel index
+
+Pre-built `llama-cpp-python` wheels are hosted at `pypi.programasweights.com`.
+Install command: `pip install programasweights --extra-index-url https://pypi.programasweights.com/simple/`
+If `llama-cpp-python` releases a new version, rebuild wheels on our servers and update the index.
+
+## PyPI credentials
+
+- Token in `~/.bashrc` on server 31.22.104.226 as `PYPI_API_TOKEN`
+- Upload via: `twine upload --username __token__ --password $PYPI_API_TOKEN`
+
+## npm credentials
+
+- Token in `~/.bashrc` on server 31.22.104.226 as `NPM_TOKEN`
+- Granular access token with publish permissions for `@programasweights` scope

{programasweights-0.2.1 → programasweights-0.2.2.dev1}/.cursor/rules/vllm-deployment.mdc

@@ -13,14 +13,26 @@ All server code lives at `/root/paw-website/` (git clone of `programasweights/we
 
 **Deployment (the ONLY way to update code):**
 ```bash
-# Local: push changes
-git push origin main
+# Local: commit and push to the website repo
+git push website main
 
-# Server: pull and restart
-cd /root/paw-website && git pull
-cd server && bash scripts/start_all.sh
+# Server: pull, build frontend, restart backend
+cd /root/paw-website && git fetch origin && git reset --hard origin/main
+cd web-app/frontend && npm run build && rsync -a --delete dist/ /data/paw-frontend/
+cd /root/paw-website/server && bash scripts/restart.sh
 ```
 
+**IMPORTANT:** `dist/` is in `.gitignore`. Frontend must be built on the server after pull.
+
+**Repos (all under github.com/programasweights/):**
+- `website` -- monorepo (server, frontend, web-sdk, docs). Deployed to server.
+- `programasweights-python` -- Python SDK source. Published to PyPI.
+- `programasweights-js` -- JS SDK source. Published to npm.
+
+**Local remote setup:**
+- `origin` = `yuntian-group/programasweights` (private monorepo)
+- `website` = `programasweights/website` (public, deployed to server)
+
 **NEVER use rsync or scp for code.** Model weights use scp between servers.
 
 ### GPU Layout

{programasweights-0.2.1 → programasweights-0.2.2.dev1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: programasweights
-Version: 0.2.1
+Version: 0.2.2.dev1
 Summary: Compile natural language specifications into neural programs that run locally via llama.cpp.
 Project-URL: Homepage, https://programasweights.com
 Project-URL: Repository, https://github.com/programasweights/programasweights-python

{programasweights-0.2.1 → programasweights-0.2.2.dev1}/programasweights/__init__.py

@@ -22,7 +22,7 @@ API reference:
     paw.api_key                API key (set via login() or PAW_API_KEY env var)
 """
 
-__version__ = "0.2.1"
+__version__ = "0.2.2.dev1"
 
 from .config import get_api_url, get_api_key, set_api_key
 
@@ -72,7 +72,7 @@ def compile(
 
 
 def function(
-    program_id: str,
+    program_id,
     n_ctx: int = 2048,
     n_gpu_layers: int | None = None,
     verbose: bool = False,
@@ -83,7 +83,7 @@ def function(
     Subsequent calls use the local cache.
 
     Args:
-        program_id: The program ID from ``paw.compile()``.
+        program_id: Program ID (str), slug, or a ``Program`` object from compile().
         n_ctx: Context window size for llama.cpp.
         n_gpu_layers: GPU layers (-1 = all, 0 = CPU only). Defaults to CPU.
             Set ``PAW_GPU_LAYERS`` env var or pass explicitly for GPU acceleration.
@@ -96,7 +96,12 @@ def function(
         >>> fn = paw.function("email-triage")
         >>> fn("Urgent: the server is down!")
         'immediate'
+
+        >>> program = paw.compile("Classify sentiment")
+        >>> fn = paw.function(program)  # accepts Program object directly
     """
+    if hasattr(program_id, 'id'):
+        program_id = program_id.slug or program_id.id
     import os
     import re
     from .cache import is_program_cached, get_program_dir, get_cached_slug, save_slug_mapping
@@ -175,9 +180,60 @@ def login(key: str | None = None):
     print("You can also set the PAW_API_KEY environment variable.")
 
 
+def compile_and_load(
+    spec: str,
+    compiler: str = "paw-4b-qwen3-0.6b",
+    n_ctx: int = 2048,
+    n_gpu_layers: int | None = None,
+    verbose: bool = False,
+    **compile_kwargs,
+):
+    """Compile a spec and immediately load it for local inference.
+
+    Convenience wrapper that combines ``paw.compile()`` and ``paw.function()``
+    into a single call.
+
+    Args:
+        spec: Natural language specification.
+        compiler: Compiler model name.
+        n_ctx: Context window size for llama.cpp.
+        n_gpu_layers: GPU layers (-1 = all, 0 = CPU only).
+        verbose: Print llama.cpp debug output.
+        **compile_kwargs: Additional args passed to compile (slug, public, etc.)
+
+    Returns:
+        A callable ``PawFunction``.
+
+    Example:
+        >>> fn = paw.compile_and_load("Classify sentiment as positive or negative")
+        >>> fn("I love this!")
+        'positive'
+    """
+    program = compile(spec, compiler=compiler, **compile_kwargs)
+    return function(program, n_ctx=n_ctx, n_gpu_layers=n_gpu_layers, verbose=verbose)
+
+
+def list_programs(sort: str = "recent", per_page: int = 20, page: int = 1) -> dict:
+    """List your compiled programs. Requires authentication (PAW_API_KEY).
+
+    Returns:
+        Dict with ``programs`` (list), ``total``, ``page``, ``per_page``.
+
+    Example:
+        >>> programs = paw.list_programs()
+        >>> for p in programs["programs"]:
+        ...     print(p["id"], p["name"])
+    """
+    from .client import PAWClient
+    client = PAWClient(api_url=api_url, api_key=api_key)
+    return client.list_programs(sort=sort, per_page=per_page, page=page)
+
+
 __all__ = [
     "compile",
+    "compile_and_load",
     "function",
+    "list_programs",
     "login",
     "api_url",
     "api_key",

{programasweights-0.2.1 → programasweights-0.2.2.dev1}/programasweights/client.py

@@ -108,18 +108,25 @@ class PAWClient:
         """Download a .paw bundle to the local cache.
 
         Returns the path to the extracted program directory.
+        Retries on 404 since freshly compiled programs may still be uploading.
         """
         program_dir = config.get_programs_dir() / program_id
         if (program_dir / "prompt_template.txt").exists():
             return program_dir
 
-        resp = httpx.get(
-            f"{self._api_url}/api/v1/programs/{program_id}/download",
-            headers=self._headers(),
-            timeout=60.0,
-            follow_redirects=True,
-        )
-        resp.raise_for_status()
+        max_retries = 10
+        for attempt in range(max_retries):
+            resp = httpx.get(
+                f"{self._api_url}/api/v1/programs/{program_id}/download",
+                headers=self._headers(),
+                timeout=60.0,
+                follow_redirects=True,
+            )
+            if resp.status_code == 404 and attempt < max_retries - 1:
+                time.sleep(3)
+                continue
+            resp.raise_for_status()
+            break
 
         program_dir.mkdir(parents=True, exist_ok=True)
         paw_path = program_dir / f"{program_id}.paw"
@@ -140,6 +147,17 @@ class PAWClient:
         resp.raise_for_status()
         return resp.json()
 
+    def list_programs(self, sort: str = "recent", per_page: int = 20, page: int = 1) -> dict:
+        """List programs for the authenticated user."""
+        resp = httpx.get(
+            f"{self._api_url}/api/v1/programs",
+            params={"mine": "true", "sort": sort, "per_page": per_page, "page": page},
+            headers=self._headers(),
+            timeout=10.0,
+        )
+        resp.raise_for_status()
+        return resp.json()
+
 
 _default_client: PAWClient | None = None
 

{programasweights-0.2.1 → programasweights-0.2.2.dev1}/programasweights/runtime_llamacpp.py

@@ -53,12 +53,25 @@ class PawFunction:
         interpreter = self._meta.get("interpreter", "Qwen/Qwen3-0.6B")
         base_model_path = cache.get_base_model_path(interpreter)
 
-        self._llm = Llama(
-            model_path=str(base_model_path),
-            n_ctx=n_ctx,
-            n_gpu_layers=n_gpu_layers,
-            verbose=verbose,
-        )
+        if not verbose:
+            import os as _os, sys as _sys
+            _stderr_fd = _sys.stderr.fileno()
+            _devnull = _os.open(_os.devnull, _os.O_WRONLY)
+            _old_stderr = _os.dup(_stderr_fd)
+            _os.dup2(_devnull, _stderr_fd)
+
+        try:
+            self._llm = Llama(
+                model_path=str(base_model_path),
+                n_ctx=n_ctx,
+                n_gpu_layers=n_gpu_layers,
+                verbose=verbose,
+            )
+        finally:
+            if not verbose:
+                _os.dup2(_old_stderr, _stderr_fd)
+                _os.close(_devnull)
+                _os.close(_old_stderr)
 
         adapter_path = program_dir / "adapter.gguf"
         if adapter_path.exists():

{programasweights-0.2.1 → programasweights-0.2.2.dev1}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "programasweights"
-version = "0.2.1"
+version = "0.2.2.dev1"
 description = "Compile natural language specifications into neural programs that run locally via llama.cpp."
 readme = "PYPI_README.md"
 requires-python = ">=3.9"

{programasweights-0.2.1 → programasweights-0.2.2.dev1}/server/api/routes/programs.py

@@ -292,6 +292,7 @@ async def list_programs(
             "compiler_snapshot": p.compiler_snapshot,
             "interpreter": p.interpreter,
             "author": author_map[p.author_id].username if p.author_id and p.author_id in author_map else "Anonymous",
+            "author_display_name": author_map[p.author_id].display_name if p.author_id and p.author_id in author_map else None,
             "author_avatar": author_map[p.author_id].avatar_url if p.author_id and p.author_id in author_map else None,
             "author_id": p.author_id,
             "tags": p.tags or [],
@@ -412,6 +413,15 @@ async def download_program(
     program.downloads = (program.downloads or 0) + 1
     await db.commit()
 
+    settings = get_settings()
+    local_paw = Path(settings.STORAGE_PATH) / program.id / f"{program.id}.paw"
+    if local_paw.exists():
+        return FileResponse(
+            path=str(local_paw),
+            media_type="application/octet-stream",
+            filename=f"{program.id}.paw",
+        )
+
     hf_url = f"https://huggingface.co/programasweights/paw-programs/resolve/main/{program.id}.paw"
     return RedirectResponse(url=hf_url, status_code=302)
 

{programasweights-0.2.1 → programasweights-0.2.2.dev1}/server/api/services/compile_provider.py

@@ -145,7 +145,7 @@ class CompileProvider:
         self.ref_tok = AutoTokenizer.from_pretrained(ref_model, trust_remote_code=True)
 
         self.compiler_fingerprint = self._compute_fingerprint()
-        self.pseudo_cache: dict[str, str] = {}
+        self._redis_url = os.environ.get("REDIS_URL", "redis://localhost:6379/0")
         self._compiler_model_name: str | None = None
 
         logger.info("compile_provider_ready",
@@ -216,9 +216,20 @@ class CompileProvider:
         cache_key = hashlib.sha256(
             f"{rendered}|max_tokens={max_tokens}|temp=0".encode()
         ).hexdigest()[:32]
-        if cache_key in self.pseudo_cache:
-            logger.info("pseudo_gen_cache_hit", spec_len=len(spec))
-            return self.pseudo_cache[cache_key], prompt_tokens
+
+        try:
+            import asyncpg
+            db_url = os.environ.get("DATABASE_URL", "postgresql://paw:pawdev2026@localhost:5432/paw")
+            conn = await asyncpg.connect(db_url)
+            row = await conn.fetchrow(
+                "SELECT pseudo_program FROM pseudo_cache WHERE cache_key = $1", cache_key
+            )
+            await conn.close()
+            if row:
+                logger.info("pseudo_gen_cache_hit", spec_len=len(spec))
+                return row["pseudo_program"], prompt_tokens
+        except Exception:
+            pass
 
         async with httpx.AsyncClient(timeout=60.0) as client:
             resp = await client.post(
@@ -233,7 +244,17 @@ class CompileProvider:
             resp.raise_for_status()
             data = resp.json()
             pseudo = data["choices"][0]["text"].strip()
-            self.pseudo_cache[cache_key] = pseudo
+
+            try:
+                conn = await asyncpg.connect(db_url)
+                await conn.execute(
+                    "INSERT INTO pseudo_cache (cache_key, pseudo_program) VALUES ($1, $2) ON CONFLICT (cache_key) DO NOTHING",
+                    cache_key, pseudo
+                )
+                await conn.close()
+            except Exception:
+                pass
+
             return pseudo, prompt_tokens
 
     def _build_compiler_input(self, spec: str, pseudo_program: str) -> str:

{programasweights-0.2.1 → programasweights-0.2.2.dev1}/tests/test_sdk.py

@@ -442,3 +442,85 @@ class TestCLIRename:
         assert result.returncode == 0
         data = json.loads(result.stdout)
         assert data.get("program_id")
+
+
+# ── Phase 12: New convenience methods ──
+
+
+class TestCompileAndLoad:
+    def test_compile_and_load_returns_callable(self):
+        fn = paw.compile_and_load("Classify text as positive or negative sentiment.")
+        assert callable(fn)
+        result = fn("I love this product!")
+        assert isinstance(result, str)
+        assert len(result) > 0
+
+    def test_compile_and_load_with_compiler(self):
+        fn = paw.compile_and_load(
+            "Count the vowels in the input. Return just the number.",
+            compiler="paw-4b-qwen3-0.6b",
+        )
+        result = fn("hello")
+        assert isinstance(result, str)
+
+
+class TestFunctionAcceptsProgram:
+    def test_function_with_program_object(self):
+        program = paw.compile("Classify text as positive or negative sentiment.")
+        fn = paw.function(program)
+        assert callable(fn)
+        result = fn("Great product!")
+        assert isinstance(result, str)
+        assert len(result) > 0
+
+    def test_function_with_string_still_works(self):
+        fn = paw.function("email-triage")
+        assert callable(fn)
+
+
+class TestListPrograms:
+    @needs_auth
+    def test_list_programs_returns_dict(self):
+        old_key = paw.api_key
+        try:
+            paw.api_key = API_KEY
+            result = paw.list_programs()
+            assert isinstance(result, dict)
+            assert "programs" in result
+            assert "total" in result
+            assert isinstance(result["programs"], list)
+        finally:
+            paw.api_key = old_key
+
+    @needs_auth
+    def test_list_programs_has_entries(self):
+        old_key = paw.api_key
+        try:
+            paw.api_key = API_KEY
+            result = paw.list_programs(per_page=5)
+            assert len(result["programs"]) <= 5
+            if result["programs"]:
+                p = result["programs"][0]
+                assert "id" in p
+                assert "spec" in p
+        finally:
+            paw.api_key = old_key
+
+
+class TestStderrSuppression:
+    def test_no_stderr_by_default(self):
+        result = subprocess.run(
+            [sys.executable, "-c",
+             "import programasweights as paw; fn = paw.function('email-triage'); fn('test')"],
+            capture_output=True, text=True, timeout=120,
+        )
+        assert "n_ctx_seq" not in result.stderr
+        assert "llama_context" not in result.stderr
+
+    def test_stderr_with_verbose(self):
+        result = subprocess.run(
+            [sys.executable, "-c",
+             "import programasweights as paw; fn = paw.function('email-triage', verbose=True); fn('test')"],
+            capture_output=True, text=True, timeout=120,
+        )
+        assert result.returncode == 0

{programasweights-0.2.1 → programasweights-0.2.2.dev1}/tests/test_sdk.sh

@@ -39,7 +39,7 @@ PY="$VENV_DIR/bin/python"
 # Step 2: Install from PyPI (timed)
 echo ">>> Installing programasweights from PyPI..."
 START=$(date +%s)
-$PIP install --no-cache-dir programasweights --extra-index-url "$EXTRA_INDEX" -q 2>&1
+$PIP install --no-cache-dir --upgrade programasweights --extra-index-url "$EXTRA_INDEX" -q 2>&1
 END=$(date +%s)
 INSTALL_TIME=$((END - START))
 echo "    Install time: ${INSTALL_TIME}s"

{programasweights-0.2.1 → programasweights-0.2.2.dev1}/web-app/frontend/e2e/full.spec.ts

@@ -210,20 +210,18 @@ test.describe('Playground', () => {
     await expect(page.locator('button', { hasText: /Compile/i }).first()).toBeVisible();
   });
 
-  test('compiler select dropdown exists and has options', async ({ page }) => {
-    const select = page.locator('select').first();
-    await expect(select).toBeVisible();
-    const options = select.locator('option');
-    expect(await options.count()).toBeGreaterThanOrEqual(1);
-  });
-
-  test('compiler select can switch', async ({ page }) => {
-    const select = page.locator('select').first();
-    const options = select.locator('option');
-    const count = await options.count();
-    if (count > 1) {
-      const val = await options.nth(1).getAttribute('value');
-      if (val) await select.selectOption(val);
+  test('compile button shows interpreter name', async ({ page }) => {
+    const compileBtn = page.locator('button', { hasText: /Compile.*Standard|Compile.*Compact/ }).first();
+    await expect(compileBtn).toBeVisible();
+  });
+
+  test('compiler dropdown opens and has options', async ({ page }) => {
+    const chevron = page.locator('button:has(svg.lucide-chevron-down)').first();
+    if (await chevron.isVisible()) {
+      await chevron.click();
+      await page.waitForTimeout(300);
+      const options = page.locator('button', { hasText: /Standard|Compact/ });
+      expect(await options.count()).toBeGreaterThanOrEqual(1);
     }
   });
 

{programasweights-0.2.1 → programasweights-0.2.2.dev1}/web-app/frontend/src/components/AuthorPage.tsx

@@ -20,7 +20,8 @@ const AuthorPage: React.FC = () => {
   const { id } = useParams<{ id: string }>();
   const [programs, setPrograms] = useState<ProgramSummary[]>([]);
   const [loading, setLoading] = useState(true);
-  const [authorName, setAuthorName] = useState('');
+  const [authorUsername, setAuthorUsername] = useState('');
+  const [authorDisplayName, setAuthorDisplayName] = useState('');
   const [authorAvatar, setAuthorAvatar] = useState('');
 
   useEffect(() => {
@@ -29,7 +30,8 @@ const AuthorPage: React.FC = () => {
       .then(res => {
         setPrograms(res.programs);
         if (res.programs.length > 0) {
-          setAuthorName(res.programs[0].author || 'Anonymous');
+          setAuthorUsername(res.programs[0].author || 'Anonymous');
+          setAuthorDisplayName((res.programs[0] as any).author_display_name || '');
           setAuthorAvatar((res.programs[0] as any).author_avatar || '');
         }
       })
@@ -51,12 +53,15 @@ const AuthorPage: React.FC = () => {
             <img src={authorAvatar} alt="" className="w-16 h-16 rounded-full border-2 border-gray-200" />
           ) : (
             <div className="w-16 h-16 rounded-full bg-gray-300 flex items-center justify-center text-xl font-medium text-gray-600">
-              {(authorName || '?')[0].toUpperCase()}
+              {(authorUsername || '?')[0].toUpperCase()}
             </div>
           )}
           <div>
-            <h1 className="text-2xl font-bold text-gray-900">{authorName}</h1>
-            <p className="text-gray-500">{programs.length} public programs</p>
+            <h1 className="text-2xl font-bold text-gray-900">{authorDisplayName || authorUsername}</h1>
+            {authorDisplayName && authorUsername !== authorDisplayName && (
+              <p className="text-sm text-gray-400">@{authorUsername}</p>
+            )}
+            <p className="text-gray-500">{programs.length} public program{programs.length !== 1 ? 's' : ''}</p>
           </div>
         </div>
       </div>

{programasweights-0.2.1 → programasweights-0.2.2.dev1}/web-app/frontend/src/components/Footer.tsx

@@ -18,7 +18,7 @@ const Footer: React.FC = () => {
               Define functions in English. Compile them into neural programs. Run them locally.
             </p>
             <div className="mt-4 inline-flex items-center gap-2 bg-white/5 rounded px-3 py-1.5 font-mono text-xs text-gray-300 border border-white/10">
-              pip install programasweights --extra-index-url https://pypi.programasweights.com/simple/
+              pip install programasweights
             </div>
           </div>
 

{programasweights-0.2.1 → programasweights-0.2.2.dev1}/web-app/frontend/src/components/HubProgramPage.tsx

@@ -18,7 +18,6 @@ const HubProgramPage: React.FC = () => {
   const [testOutput, setTestOutput] = useState('');
   const [testRunning, setTestRunning] = useState(false);
   const [copied, setCopied] = useState(false);
-  const [copiedUsage, setCopiedUsage] = useState(false);
   const [copiedShare, setCopiedShare] = useState(false);
   const [showPseudo, setShowPseudo] = useState(false);
   const [userVote, setUserVote] = useState<1 | -1 | null>(null);
@@ -263,16 +262,12 @@ console.log(result);`;
         <div className="border-t border-gray-100 bg-gray-50 px-6 sm:px-8 py-3 flex flex-wrap gap-2">
           <button
             onClick={() => {
-              const code = `import programasweights as paw\nfn = paw.function("${codeRef}")`;
-              navigator.clipboard.writeText(code);
-              setCopiedUsage(true);
+              navigator.clipboard.writeText(usageCode);
               toast.success('Copied!');
-              setTimeout(() => setCopiedUsage(false), 2000);
             }}
             className="inline-flex items-center gap-2 px-4 py-2 bg-gray-900 text-white rounded-lg hover:bg-gray-800 transition-colors text-sm font-medium"
           >
-            {copiedUsage ? <Check className="w-4 h-4" /> : <Copy className="w-4 h-4" />}
-            {copiedUsage ? 'Copied!' : 'Copy usage'}
+            <Copy className="w-4 h-4" /> Copy usage
           </button>
           <button onClick={handleFork} className="inline-flex items-center gap-2 px-4 py-2 bg-white text-gray-700 border border-gray-200 rounded-lg hover:bg-gray-50 transition-colors text-sm font-medium">
             <GitFork className="w-4 h-4" /> Fork & Edit
@@ -336,18 +331,9 @@ console.log(result);`;
 
       {/* Usage Code */}
       <div className="bg-white rounded-xl border border-gray-200 p-6">
-        <div className="flex items-center justify-between mb-3">
-          <div className="flex items-center gap-2">
-            <Code className="w-4 h-4 text-gray-400" />
-            <h2 className="font-semibold text-gray-900">Usage</h2>
-          </div>
-          <button
-            onClick={() => { navigator.clipboard.writeText(usageCode); setCopied(true); setTimeout(() => setCopied(false), 2000); }}
-            className="inline-flex items-center gap-1.5 px-3 py-1.5 text-xs text-gray-500 hover:text-gray-900 bg-gray-50 rounded-lg hover:bg-gray-100 transition-colors font-medium"
-          >
-            {copied ? <Check className="w-3.5 h-3.5 text-green-600" /> : <Copy className="w-3.5 h-3.5" />}
-            {copied ? 'Copied!' : 'Copy'}
-          </button>
+        <div className="flex items-center gap-2 mb-3">
+          <Code className="w-4 h-4 text-gray-400" />
+          <h2 className="font-semibold text-gray-900">Usage</h2>
         </div>
         {isBrowserCapable && (
           <div className="flex gap-1 mb-3">
@@ -359,7 +345,15 @@ console.log(result);`;
             >JavaScript (browser)</button>
           </div>
         )}
-        <pre className="bg-gray-900 text-gray-100 p-4 rounded-lg text-sm overflow-x-auto leading-relaxed">{usageCode}</pre>
+        <div className="relative">
+          <pre className="bg-gray-900 text-gray-100 p-4 rounded-lg text-sm overflow-x-auto leading-relaxed">{usageCode}</pre>
+          <button
+            onClick={() => { navigator.clipboard.writeText(usageCode); setCopied(true); toast.success('Copied!'); setTimeout(() => setCopied(false), 2000); }}
+            className="absolute top-2 right-2 p-1.5 bg-gray-700 hover:bg-gray-600 text-gray-300 rounded transition-colors"
+          >
+            {copied ? <Check className="w-4 h-4 text-green-400" /> : <Copy className="w-4 h-4" />}
+          </button>
+        </div>
         <p className="mt-3 text-xs text-gray-400">
           Install with <code className="bg-gray-100 px-1.5 py-0.5 rounded text-gray-600">{installCmd}</code>
         </p>

{programasweights-0.2.1 → programasweights-0.2.2.dev1}/web-app/frontend/src/components/LandingPage.tsx

@@ -130,10 +130,11 @@ print(result)  # "immediate"`;
               <div className="mt-8">
                 <div className="inline-flex items-center gap-3 bg-black/30 rounded-lg pl-4 pr-2 py-2 border border-white/10 font-mono text-sm">
                   <span className="text-gray-400">$</span>
-                  <span className="text-green-300">{installCmd}</span>
+                  <span className="text-green-300">pip install programasweights</span>
                   <button
                     onClick={() => copyToClipboard(installCmd, 'install')}
                     className="p-1.5 rounded hover:bg-white/10 transition-colors text-gray-400 hover:text-white"
+                    title="Copy full install command"
                   >
                     {copiedInstall ? <Check className="w-4 h-4 text-green-400" /> : <Copy className="w-4 h-4" />}
                   </button>
@@ -527,10 +528,11 @@ print(result)  # "immediate"`;
           {/* Install snippet */}
           <div className="mt-10 inline-flex items-center gap-3 bg-black/30 rounded-lg pl-5 pr-3 py-3 border border-white/10 font-mono text-sm">
             <span className="text-gray-400">$</span>
-            <span className="text-green-300">{installCmd}</span>
+            <span className="text-green-300">pip install programasweights</span>
             <button
               onClick={() => copyToClipboard(installCmd, 'install')}
               className="p-1.5 rounded hover:bg-white/10 transition-colors text-gray-400 hover:text-white"
+              title="Copy full install command"
             >
               {copiedInstall ? <Check className="w-4 h-4 text-green-400" /> : <Copy className="w-4 h-4" />}
             </button>