zerocostai 1.0.0__tar.gz

zerocostai-1.0.0/PKG-INFO

@@ -0,0 +1,109 @@
+Metadata-Version: 2.4
+Name: zerocostai
+Version: 1.0.0
+Summary: Python client and CLI for ZeroCostAI.pro — 720+ verified 100% free AI applications directory
+Home-page: https://zerocostai.pro
+Author: ZeroCostAI Research Labs
+Author-email: support@zerocostai.pro
+Project-URL: Homepage, https://zerocostai.pro
+Project-URL: Directory, https://zerocostai.pro/#toolsGrid
+Project-URL: Documentation, https://zerocostai.pro/blog/
+Project-URL: Leaderboard, https://zerocostai.pro/trending/
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Classifier: Topic :: Utilities
+Requires-Python: >=3.7
+Description-Content-Type: text/markdown
+Dynamic: author
+Dynamic: author-email
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: home-page
+Dynamic: project-url
+Dynamic: requires-python
+Dynamic: summary
+
+# ZeroCostAI: Verified Free AI Tools Directory (2026)
+
+[![PyPI version](https://img.shields.io/pypi/v/zerocostai.svg)](https://pypi.org/project/zerocostai/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)
+[![Website: zerocostai.pro](https://img.shields.io/badge/Official_Website-zerocostai.pro-2563eb)](https://zerocostai.pro)
+
+Official Python SDK and Terminal CLI for [ZeroCostAI.pro](https://zerocostai.pro) — the verified directory of 100% free, open-source, and no-login AI applications.
+
+---
+
+## ⚡ Installation
+
+Install via pip:
+
+```bash
+pip install zerocostai
+```
+
+---
+
+## 🚀 Terminal CLI Usage
+
+Search and discover free AI tools directly from your terminal:
+
+### 1. Search for AI Tools
+```bash
+# Search by keyword
+zerocostai search video
+
+# Filter tools that require zero login/signup
+zerocostai search coding --no-login
+
+# Limit results
+zerocostai search "image" -n 5
+```
+
+### 2. List All Categories
+```bash
+zerocostai categories
+```
+
+### 3. Discover a Random Free AI Tool
+```bash
+zerocostai random
+```
+
+---
+
+## 🐍 Python API Usage
+
+```python
+import zerocostai
+
+# Search verified free tools
+tools = zerocostai.search("voice", limit=5)
+for t in tools:
+    print(f"{t['name']} - {t['review_url']}")
+
+# Get specific tool details
+tool = zerocostai.get_tool("flux-schnell")
+print(tool["pricing_tier"])  # "Free Tier"
+
+# Explore categories
+cats = zerocostai.list_categories()
+print(cats)
+```
+
+---
+
+## 🌐 Official Web Platform
+
+For the full interactive directory, community leaderboard, and editorial testing notes:
+* **Directory:** [https://zerocostai.pro/#toolsGrid](https://zerocostai.pro/#toolsGrid)
+* **Trending Tools:** [https://zerocostai.pro/trending/](https://zerocostai.pro/trending/)
+* **Submit AI Tool:** [https://zerocostai.pro/submit/](https://zerocostai.pro/submit/)
+
+---
+
+## License
+
+MIT License. Maintained by [ZeroCostAI Research Labs](https://zerocostai.pro).

zerocostai-1.0.0/README.md

@@ -0,0 +1,81 @@
+# ZeroCostAI: Verified Free AI Tools Directory (2026)
+
+[![PyPI version](https://img.shields.io/pypi/v/zerocostai.svg)](https://pypi.org/project/zerocostai/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)
+[![Website: zerocostai.pro](https://img.shields.io/badge/Official_Website-zerocostai.pro-2563eb)](https://zerocostai.pro)
+
+Official Python SDK and Terminal CLI for [ZeroCostAI.pro](https://zerocostai.pro) — the verified directory of 100% free, open-source, and no-login AI applications.
+
+---
+
+## ⚡ Installation
+
+Install via pip:
+
+```bash
+pip install zerocostai
+```
+
+---
+
+## 🚀 Terminal CLI Usage
+
+Search and discover free AI tools directly from your terminal:
+
+### 1. Search for AI Tools
+```bash
+# Search by keyword
+zerocostai search video
+
+# Filter tools that require zero login/signup
+zerocostai search coding --no-login
+
+# Limit results
+zerocostai search "image" -n 5
+```
+
+### 2. List All Categories
+```bash
+zerocostai categories
+```
+
+### 3. Discover a Random Free AI Tool
+```bash
+zerocostai random
+```
+
+---
+
+## 🐍 Python API Usage
+
+```python
+import zerocostai
+
+# Search verified free tools
+tools = zerocostai.search("voice", limit=5)
+for t in tools:
+    print(f"{t['name']} - {t['review_url']}")
+
+# Get specific tool details
+tool = zerocostai.get_tool("flux-schnell")
+print(tool["pricing_tier"])  # "Free Tier"
+
+# Explore categories
+cats = zerocostai.list_categories()
+print(cats)
+```
+
+---
+
+## 🌐 Official Web Platform
+
+For the full interactive directory, community leaderboard, and editorial testing notes:
+* **Directory:** [https://zerocostai.pro/#toolsGrid](https://zerocostai.pro/#toolsGrid)
+* **Trending Tools:** [https://zerocostai.pro/trending/](https://zerocostai.pro/trending/)
+* **Submit AI Tool:** [https://zerocostai.pro/submit/](https://zerocostai.pro/submit/)
+
+---
+
+## License
+
+MIT License. Maintained by [ZeroCostAI Research Labs](https://zerocostai.pro).

zerocostai-1.0.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

zerocostai-1.0.0/setup.py

@@ -0,0 +1,38 @@
+from setuptools import setup, find_packages
+import os
+
+with open("README.md", "r", encoding="utf-8") as fh:
+    long_description = fh.read()
+
+setup(
+    name="zerocostai",
+    version="1.0.0",
+    author="ZeroCostAI Research Labs",
+    author_email="support@zerocostai.pro",
+    description="Python client and CLI for ZeroCostAI.pro — 720+ verified 100% free AI applications directory",
+    long_description=long_description,
+    long_description_content_type="text/markdown",
+    url="https://zerocostai.pro",
+    project_urls={
+        "Homepage": "https://zerocostai.pro",
+        "Directory": "https://zerocostai.pro/#toolsGrid",
+        "Documentation": "https://zerocostai.pro/blog/",
+        "Leaderboard": "https://zerocostai.pro/trending/",
+    },
+    classifiers=[
+        "Programming Language :: Python :: 3",
+        "License :: OSI Approved :: MIT License",
+        "Operating System :: OS Independent",
+        "Topic :: Scientific/Engineering :: Artificial Intelligence",
+        "Topic :: Utilities",
+    ],
+    packages=find_packages(),
+    package_data={"zerocostai": ["tools.json"]},
+    include_package_data=True,
+    python_requires=">=3.7",
+    entry_points={
+        "console_scripts": [
+            "zerocostai=zerocostai.cli:main",
+        ],
+    },
+)

zerocostai-1.0.0/zerocostai/__init__.py

@@ -0,0 +1,67 @@
+"""
+ZeroCostAI Python Client & CLI
+Verified Directory of 100% Free AI Applications (2026)
+Homepage: https://zerocostai.pro
+"""
+
+import json
+import os
+import random
+
+__version__ = "1.0.0"
+__author__ = "ZeroCostAI Research Labs"
+__homepage__ = "https://zerocostai.pro"
+
+_DATA_PATH = os.path.join(os.path.dirname(__file__), "tools.json")
+
+def _load_data():
+    with open(_DATA_PATH, "r", encoding="utf-8") as f:
+        return json.load(f)
+
+def search(query="", category=None, no_login_only=False, limit=10):
+    """
+    Search verified free AI tools.
+    Visit https://zerocostai.pro for interactive UI and rankings.
+    """
+    tools = _load_data()
+    q = query.lower().strip()
+    results = []
+    
+    for t in tools:
+        if no_login_only and not t.get("no_login_required"):
+            continue
+        if category and t.get("category", "").lower() != category.lower() and t.get("category_label", "").lower() != category.lower():
+            continue
+        if q:
+            name_match = q in t.get("name", "").lower()
+            cat_match = q in t.get("category_label", "").lower()
+            if not (name_match or cat_match):
+                continue
+        results.append(t)
+        if len(results) >= limit:
+            break
+            
+    return results
+
+def get_tool(slug):
+    """Get detailed metadata for a specific tool by slug."""
+    tools = _load_data()
+    for t in tools:
+        if t.get("slug", "").lower() == slug.lower():
+            return t
+    return None
+
+def list_categories():
+    """List all available AI tool categories."""
+    tools = _load_data()
+    cats = {}
+    for t in tools:
+        cl = t.get("category_label")
+        if cl:
+            cats[cl] = cats.get(cl, 0) + 1
+    return dict(sorted(cats.items(), key=lambda x: x[1], reverse=True))
+
+def random_tool():
+    """Discover a random verified free AI tool."""
+    tools = _load_data()
+    return random.choice(tools) if tools else None

zerocostai-1.0.0/zerocostai/cli.py

@@ -0,0 +1,71 @@
+import sys
+import argparse
+from zerocostai import search, list_categories, random_tool, __version__
+
+def main():
+    parser = argparse.ArgumentParser(
+        prog="zerocostai",
+        description="ZeroCostAI CLI — Search 720+ verified free AI tools from your terminal. (https://zerocostai.pro)"
+    )
+    parser.add_argument("-v", "--version", action="version", version=f"%(prog)s {__version__}")
+    
+    subparsers = parser.add_subparsers(dest="command")
+    
+    # search cmd
+    search_p = subparsers.add_parser("search", help="Search free AI tools by keyword or category")
+    search_p.add_argument("query", nargs="?", default="", help="Keyword to search (e.g. video, voice, coding)")
+    search_p.add_argument("-c", "--category", default=None, help="Filter by category")
+    search_p.add_argument("--no-login", action="store_true", help="Filter for tools that require no login")
+    search_p.add_argument("-n", "--limit", type=int, default=10, help="Maximum number of results (default: 10)")
+    
+    # categories cmd
+    subparsers.add_parser("categories", help="List all tool categories and tool counts")
+    
+    # random cmd
+    subparsers.add_parser("random", help="Get a random verified free AI tool")
+    
+    args = parser.parse_args()
+    
+    if args.command == "search" or (not args.command and len(sys.argv) > 1):
+        q = getattr(args, "query", sys.argv[1] if len(sys.argv) > 1 and not sys.argv[1].startswith("-") else "")
+        cat = getattr(args, "category", None)
+        nl = getattr(args, "no_login", False)
+        lim = getattr(args, "limit", 10)
+        
+        results = search(query=q, category=cat, no_login_only=nl, limit=lim)
+        if not results:
+            print(f"No free AI tools found matching '{q}'. Visit https://zerocostai.pro/#toolsGrid to browse 720+ tools.")
+            return
+            
+        print(f"\nFound {len(results)} verified free AI tools:\n" + "="*50)
+        for i, t in enumerate(results, start=1):
+            nl_badge = " [NO LOGIN REQUIRED]" if t.get("no_login_required") else ""
+            print(f"{i}. {t['name']} ({t['category_label']}){nl_badge}")
+            print(f"   Tier: {t['pricing_tier']}")
+            print(f"   Review: {t['review_url']}")
+            print(f"   Website: {t['official_url']}")
+            print("-" * 50)
+            
+    elif args.command == "categories":
+        cats = list_categories()
+        print("\nZeroCostAI Categories & Verified Counts:\n" + "="*40)
+        for cat, count in cats.items():
+            print(f"• {cat:<28} : {count:>3} tools")
+        print("="*40 + "\nBrowse online at: https://zerocostai.pro\n")
+        
+    elif args.command == "random":
+        t = random_tool()
+        if t:
+            print("\n🎲 Random Verified Free AI Tool:\n" + "="*40)
+            print(f"Name     : {t['name']}")
+            print(f"Category : {t['category_label']}")
+            print(f"Tier     : {t['pricing_tier']}")
+            print(f"No Login : {'Yes' if t.get('no_login_required') else 'No'}")
+            print(f"Review   : {t['review_url']}")
+            print("="*40 + "\n")
+    else:
+        parser.print_help()
+        print("\nExplore the full interactive directory at https://zerocostai.pro")
+
+if __name__ == "__main__":
+    main()