linkup-cli 0.1.0__tar.gz

linkup_cli-0.1.0/PKG-INFO

@@ -0,0 +1,127 @@
+Metadata-Version: 2.4
+Name: linkup-cli
+Version: 0.1.0
+Summary: Official CLI for Linkup - AI-powered web search
+Project-URL: Homepage, https://linkup.so
+Project-URL: Documentation, https://docs.linkup.so
+Project-URL: Repository, https://github.com/LinkupPlatform/linkup-cli
+Project-URL: Issues, https://github.com/LinkupPlatform/linkup-cli/issues
+Author-email: Linkup <support@linkup.so>
+License-Expression: MIT
+Keywords: ai,cli,linkup,search,web-search
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Internet :: WWW/HTTP :: Indexing/Search
+Requires-Python: >=3.9
+Requires-Dist: linkup-sdk>=0.2.0
+Requires-Dist: rich>=13.0.0
+Description-Content-Type: text/markdown
+
+# Linkup CLI
+
+Official command-line interface for [Linkup](https://linkup.so) - AI-powered web search.
+
+## Installation
+
+```bash
+pip install linkup-cli
+```
+
+## Quick Start
+
+1. Get your API key at [app.linkup.so](https://app.linkup.so)
+
+2. Set your API key:
+```bash
+export LINKUP_API_KEY="your-api-key"
+```
+
+3. Search:
+```bash
+linkup search "What is the capital of France?"
+```
+
+## Usage
+
+### Search
+
+```bash
+# Basic search
+linkup search "your query"
+
+# Deep search (more thorough, better for complex queries)
+linkup search "complex research topic" --deep
+
+# Get raw search results instead of AI answer
+linkup search "python tutorials" --results
+
+# Short form
+linkup s "your query" -d
+```
+
+### Fetch
+
+Extract content from any URL:
+
+```bash
+linkup fetch "https://example.com"
+```
+
+### Configuration
+
+Check your configuration:
+
+```bash
+linkup config
+```
+
+## Options
+
+| Flag | Short | Description |
+|------|-------|-------------|
+| `--deep` | `-d` | Use deep search for complex queries |
+| `--results` | `-r` | Return raw search results |
+| `--version` | `-V` | Show version |
+| `--help` | `-h` | Show help |
+
+## Environment Variables
+
+| Variable | Description |
+|----------|-------------|
+| `LINKUP_API_KEY` | Your Linkup API key (required) |
+
+## Examples
+
+```bash
+# Quick facts
+linkup search "population of tokyo"
+
+# Research
+linkup search "latest developments in quantum computing" --deep
+
+# Get sources
+linkup search "best python web frameworks" --results
+
+# Extract article content
+linkup fetch "https://example.com/article"
+```
+
+## Links
+
+- [Linkup Website](https://linkup.so)
+- [Documentation](https://docs.linkup.so)
+- [Get API Key](https://app.linkup.so)
+- [Python SDK](https://github.com/LinkupPlatform/linkup-python-sdk)
+
+## License
+
+MIT

linkup_cli-0.1.0/README.md

@@ -0,0 +1,99 @@
+# Linkup CLI
+
+Official command-line interface for [Linkup](https://linkup.so) - AI-powered web search.
+
+## Installation
+
+```bash
+pip install linkup-cli
+```
+
+## Quick Start
+
+1. Get your API key at [app.linkup.so](https://app.linkup.so)
+
+2. Set your API key:
+```bash
+export LINKUP_API_KEY="your-api-key"
+```
+
+3. Search:
+```bash
+linkup search "What is the capital of France?"
+```
+
+## Usage
+
+### Search
+
+```bash
+# Basic search
+linkup search "your query"
+
+# Deep search (more thorough, better for complex queries)
+linkup search "complex research topic" --deep
+
+# Get raw search results instead of AI answer
+linkup search "python tutorials" --results
+
+# Short form
+linkup s "your query" -d
+```
+
+### Fetch
+
+Extract content from any URL:
+
+```bash
+linkup fetch "https://example.com"
+```
+
+### Configuration
+
+Check your configuration:
+
+```bash
+linkup config
+```
+
+## Options
+
+| Flag | Short | Description |
+|------|-------|-------------|
+| `--deep` | `-d` | Use deep search for complex queries |
+| `--results` | `-r` | Return raw search results |
+| `--version` | `-V` | Show version |
+| `--help` | `-h` | Show help |
+
+## Environment Variables
+
+| Variable | Description |
+|----------|-------------|
+| `LINKUP_API_KEY` | Your Linkup API key (required) |
+
+## Examples
+
+```bash
+# Quick facts
+linkup search "population of tokyo"
+
+# Research
+linkup search "latest developments in quantum computing" --deep
+
+# Get sources
+linkup search "best python web frameworks" --results
+
+# Extract article content
+linkup fetch "https://example.com/article"
+```
+
+## Links
+
+- [Linkup Website](https://linkup.so)
+- [Documentation](https://docs.linkup.so)
+- [Get API Key](https://app.linkup.so)
+- [Python SDK](https://github.com/LinkupPlatform/linkup-python-sdk)
+
+## License
+
+MIT

linkup_cli-0.1.0/pyproject.toml

@@ -0,0 +1,45 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "linkup-cli"
+version = "0.1.0"
+description = "Official CLI for Linkup - AI-powered web search"
+readme = "README.md"
+license = "MIT"
+requires-python = ">=3.9"
+authors = [
+    { name = "Linkup", email = "support@linkup.so" }
+]
+keywords = ["linkup", "cli", "search", "ai", "web-search"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Environment :: Console",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.9",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Topic :: Internet :: WWW/HTTP :: Indexing/Search",
+]
+dependencies = [
+    "linkup-sdk>=0.2.0",
+    "rich>=13.0.0",
+]
+
+[project.urls]
+Homepage = "https://linkup.so"
+Documentation = "https://docs.linkup.so"
+Repository = "https://github.com/LinkupPlatform/linkup-cli"
+Issues = "https://github.com/LinkupPlatform/linkup-cli/issues"
+
+[project.scripts]
+linkup = "linkup_cli.cli:main"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/linkup_cli"]

linkup_cli-0.1.0/src/linkup_cli/__init__.py

@@ -0,0 +1,3 @@
+"""Linkup CLI - AI-powered web search from your terminal."""
+
+__version__ = "0.1.0"

linkup_cli-0.1.0/src/linkup_cli/cli.py

@@ -0,0 +1,180 @@
+"""Linkup CLI - Search the web with AI from your terminal."""
+
+import argparse
+import os
+import sys
+
+def get_client():
+    """Initialize and return the Linkup client."""
+    api_key = os.environ.get("LINKUP_API_KEY")
+    if not api_key:
+        print("Error: LINKUP_API_KEY environment variable not set")
+        print("Get your API key at https://app.linkup.so")
+        print("\nSet it with: export LINKUP_API_KEY='your-key'")
+        sys.exit(1)
+
+    from linkup import LinkupClient
+    return LinkupClient(api_key=api_key)
+
+
+def cmd_search(args):
+    """Execute a search query."""
+    from rich.console import Console
+    from rich.markdown import Markdown
+    from rich.panel import Panel
+
+    console = Console()
+    client = get_client()
+
+    query = " ".join(args.query)
+    if not query:
+        console.print("[red]Error: No query provided[/red]")
+        sys.exit(1)
+
+    with console.status(f"[bold blue]Searching...[/bold blue]"):
+        response = client.search(
+            query=query,
+            depth="deep" if args.deep else "standard",
+            output_type="searchResults" if args.results else "sourcedAnswer",
+        )
+
+    if args.results:
+        # Display search results
+        for i, result in enumerate(response.results, 1):
+            console.print(f"\n[bold cyan]{i}. {result.name}[/bold cyan]")
+            console.print(f"   [dim]{result.url}[/dim]")
+            if result.content:
+                snippet = result.content[:300] + "..." if len(result.content) > 300 else result.content
+                console.print(f"   {snippet}")
+    else:
+        # Display sourced answer
+        console.print()
+        console.print(Markdown(response.answer))
+
+        if hasattr(response, "sources") and response.sources:
+            console.print("\n[bold]Sources:[/bold]")
+            for src in response.sources[:5]:
+                console.print(f"  [dim]•[/dim] [link={src.url}]{src.name}[/link]")
+
+    console.print()
+
+
+def cmd_fetch(args):
+    """Fetch and extract content from a URL."""
+    from rich.console import Console
+    from rich.markdown import Markdown
+
+    console = Console()
+    client = get_client()
+
+    with console.status(f"[bold blue]Fetching {args.url}...[/bold blue]"):
+        response = client.fetch(url=args.url)
+
+    console.print()
+    console.print(Markdown(response.content))
+    console.print()
+
+
+def cmd_config(args):
+    """Show or set configuration."""
+    from rich.console import Console
+    from rich.table import Table
+
+    console = Console()
+
+    table = Table(title="Linkup CLI Configuration")
+    table.add_column("Setting", style="cyan")
+    table.add_column("Value", style="green")
+
+    api_key = os.environ.get("LINKUP_API_KEY", "")
+    masked_key = f"{api_key[:8]}...{api_key[-4:]}" if len(api_key) > 12 else "(not set)"
+
+    table.add_row("API Key", masked_key)
+    table.add_row("API Key Set", "Yes" if api_key else "[red]No[/red]")
+
+    console.print()
+    console.print(table)
+    console.print()
+
+    if not api_key:
+        console.print("[yellow]To set your API key:[/yellow]")
+        console.print("  export LINKUP_API_KEY='your-key'")
+        console.print("\nGet your API key at: [link=https://app.linkup.so]https://app.linkup.so[/link]")
+        console.print()
+
+
+def main():
+    """Main CLI entry point."""
+    parser = argparse.ArgumentParser(
+        prog="linkup",
+        description="Linkup CLI - AI-powered web search from your terminal",
+        formatter_class=argparse.RawDescriptionHelpFormatter,
+        epilog="""
+Examples:
+  linkup search "What is the capital of France?"
+  linkup search "Latest AI news" --deep
+  linkup search "Python tutorials" --results
+  linkup fetch "https://example.com"
+  linkup config
+
+Get your API key at: https://app.linkup.so
+Documentation: https://docs.linkup.so
+        """,
+    )
+    parser.add_argument(
+        "--version", "-V", action="version", version="%(prog)s 0.1.0"
+    )
+
+    subparsers = parser.add_subparsers(dest="command", help="Available commands")
+
+    # Search command
+    search_parser = subparsers.add_parser(
+        "search", aliases=["s"], help="Search the web"
+    )
+    search_parser.add_argument("query", nargs="*", help="Search query")
+    search_parser.add_argument(
+        "--deep", "-d", action="store_true",
+        help="Use deep search for complex queries"
+    )
+    search_parser.add_argument(
+        "--results", "-r", action="store_true",
+        help="Return raw search results instead of AI answer"
+    )
+    search_parser.set_defaults(func=cmd_search)
+
+    # Fetch command
+    fetch_parser = subparsers.add_parser(
+        "fetch", aliases=["f"], help="Fetch and extract content from a URL"
+    )
+    fetch_parser.add_argument("url", help="URL to fetch")
+    fetch_parser.set_defaults(func=cmd_fetch)
+
+    # Config command
+    config_parser = subparsers.add_parser(
+        "config", aliases=["c"], help="Show configuration"
+    )
+    config_parser.set_defaults(func=cmd_config)
+
+    # Parse args
+    args = parser.parse_args()
+
+    # Handle no command - default to search if args look like a query
+    if args.command is None:
+        # Check if there are extra args that might be a query
+        if len(sys.argv) > 1 and not sys.argv[1].startswith("-"):
+            # Treat as implicit search
+            sys.argv.insert(1, "search")
+            args = parser.parse_args()
+        else:
+            parser.print_help()
+            sys.exit(0)
+
+    # Execute command
+    if hasattr(args, "func"):
+        args.func(args)
+    else:
+        parser.print_help()
+
+
+if __name__ == "__main__":
+    main()