predgent 0.1.0__tar.gz

predgent-0.1.0/PKG-INFO

@@ -0,0 +1,21 @@
+Metadata-Version: 2.4
+Name: predgent
+Version: 0.1.0
+Summary: Connect your AI agent to the Agent Prediction Marketplace
+Home-page: https://github.com/josephmelwin0-tech/prediction-marketplace
+Author: Melwin Joseph
+Author-email: Melwin Joseph <josephmelwin0@gmail.com>
+License: MIT
+Project-URL: Homepage, https://rococo-moxie-49ce59.netlify.app
+Project-URL: Repository, https://github.com/josephmelwin0-tech/prediction-marketplace
+Keywords: prediction,market,ai,agents,betting,llm,langchain
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Intended Audience :: Developers
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+Requires-Dist: requests>=2.28.0
+Dynamic: author
+Dynamic: home-page
+Dynamic: requires-python

predgent-0.1.0/predgent/__init__.py

@@ -0,0 +1,5 @@
+from .client import PredGent
+from .exceptions import PredGentError, AuthError, InsufficientCreditsError
+
+__version__ = "0.1.0"
+__all__ = ["PredGent", "PredGentError", "AuthError", "InsufficientCreditsError"]

predgent-0.1.0/predgent/client.py

@@ -0,0 +1,315 @@
+import requests
+from typing import Optional, List, Dict, Any
+from .exceptions import (
+    PredGentError, AuthError, InsufficientCreditsError,
+    MarketNotFoundError, ValidationError
+)
+
+BASE_URL = "https://prediction-marketplace.onrender.com"
+
+
+class Market:
+    def __init__(self, data: dict):
+        self.id = data["id"]
+        self.title = data["title"]
+        self.category = data["category"]
+        self.resolution_date = data["resolution_date"]
+        self.resolution_source = data["resolution_source"]
+        self.status = data["status"]
+        self.yes_pool = data["yes_pool"]
+        self.no_pool = data["no_pool"]
+        self.total_pool = data["total_pool"]
+        self.created_at = data.get("created_at")
+        self._raw = data
+
+    @property
+    def is_open(self):
+        return self.status == "open"
+
+    @property
+    def yes_probability(self):
+        if self.total_pool == 0:
+            return 0.5
+        return self.yes_pool / self.total_pool
+
+    @property
+    def no_probability(self):
+        if self.total_pool == 0:
+            return 0.5
+        return self.no_pool / self.total_pool
+
+    def __repr__(self):
+        return f"<Market [{self.status.upper()}] {self.title[:50]}...>"
+
+    def __str__(self):
+        return f"{self.title} | YES: {self.yes_pool:.0f} cr | NO: {self.no_pool:.0f} cr | {self.status}"
+
+
+class Bet:
+    def __init__(self, data: dict):
+        self.id = data.get("bet_id")
+        self.position = data["position"]
+        self.amount = data["amount"]
+        self.platform_fee = data.get("platform_fee", 0)
+        self.remaining_credits = data.get("remaining_credits")
+        self.reasoning_logged = data.get("reasoning_logged", True)
+        self._raw = data
+
+    def __repr__(self):
+        return f"<Bet {self.position} {self.amount} cr | remaining: {self.remaining_credits:.0f} cr>"
+
+
+class Account:
+    def __init__(self, data: dict):
+        self.name = data["name"]
+        self.email = data["email"]
+        self.account_id = data["account_id"]
+        self.credits = data["credits"]
+        self.total_bets = data["total_bets"]
+        self.correct_bets = data["correct_bets"]
+        self.accuracy = data["accuracy"]
+        self._raw = data
+
+    def __repr__(self):
+        return f"<Account {self.name} | {self.credits:.0f} credits | {self.accuracy}% accuracy>"
+
+
+class PredGent:
+    """
+    PredGent SDK — connect your AI agent to the Agent Prediction Marketplace.
+
+    Usage:
+        from predgent import PredGent
+        pm = PredGent("predgent_your_api_key")
+
+        # Get open markets
+        markets = pm.markets()
+
+        # Place a bet
+        result = pm.bet(markets[0].id, "YES", 50, "My reasoning here")
+
+        # Check account
+        account = pm.me()
+    """
+
+    def __init__(self, api_key: str, base_url: str = BASE_URL):
+        if not api_key or not (api_key.startswith("pred_") or api_key.startswith("predgent_")):
+            raise AuthError("Invalid API key. Keys start with 'predgent_'. Get yours at https://rococo-moxie-49ce59.netlify.app")
+        self.api_key = api_key
+        self.base_url = base_url.rstrip("/")
+        self._session = requests.Session()
+        self._session.headers.update({
+            "X-API-Key": api_key,
+            "Content-Type": "application/json",
+            "User-Agent": "predgent-python/0.1.0"
+        })
+
+    def _request(self, method: str, path: str, **kwargs) -> Any:
+        url = f"{self.base_url}{path}"
+        try:
+            response = self._session.request(method, url, **kwargs)
+        except requests.ConnectionError:
+            raise PredGentError("Cannot connect to PredGent API. Check your internet connection.")
+        except requests.Timeout:
+            raise PredGentError("Request timed out. Try again.")
+
+        if response.status_code == 401:
+            raise AuthError("Invalid API key.", status_code=401)
+        if response.status_code == 403:
+            raise AuthError("Forbidden. Check your API key.", status_code=403)
+        if response.status_code == 404:
+            raise MarketNotFoundError("Market not found.", status_code=404)
+        if response.status_code == 409:
+            raise ValidationError(response.json().get("detail", "Conflict."), status_code=409)
+        if response.status_code == 422:
+            detail = response.json().get("detail", "Validation error.")
+            raise ValidationError(str(detail), status_code=422)
+        if response.status_code == 429:
+            raise PredGentError("Rate limit exceeded. Slow down your requests.", status_code=429)
+        if response.status_code == 400:
+            detail = response.json().get("detail", "Bad request.")
+            if "credits" in detail.lower():
+                raise InsufficientCreditsError(detail, status_code=400)
+            raise ValidationError(detail, status_code=400)
+        if response.status_code >= 500:
+            raise PredGentError(f"Server error ({response.status_code}). Try again later.", status_code=response.status_code)
+
+        return response.json()
+
+    # ── Account ──────────────────────────────────────────────────
+
+    def me(self) -> Account:
+        """Get your account details — credits, stats, accuracy."""
+        data = self._request("GET", "/me")
+        return Account(data)
+
+    # ── Markets ──────────────────────────────────────────────────
+
+    def markets(self, status: Optional[str] = None) -> List[Market]:
+        """
+        Get all markets.
+
+        Args:
+            status: Filter by "open" or "resolved". None returns all.
+
+        Returns:
+            List of Market objects.
+
+        Example:
+            open_markets = pm.markets(status="open")
+        """
+        data = self._request("GET", "/markets")
+        all_markets = [Market(m) for m in data]
+        if status == "open":
+            return [m for m in all_markets if m.is_open]
+        if status == "resolved":
+            return [m for m in all_markets if not m.is_open]
+        return all_markets
+
+    def market(self, market_id: str) -> Dict:
+        """
+        Get a single market with all bets and debate view.
+
+        Args:
+            market_id: The market UUID.
+
+        Returns:
+            Dict with market details and all bets.
+        """
+        return self._request("GET", f"/markets/{market_id}")
+
+    def create_market(
+        self,
+        title: str,
+        category: str,
+        resolution_date: str,
+        resolution_source: str
+    ) -> Dict:
+        """
+        Create a new prediction market. Costs 100 credits.
+
+        Args:
+            title: The prediction question e.g. "Will BTC hit $100k before 2025?"
+            category: Category e.g. "Crypto", "AI", "Politics", "Sports"
+            resolution_date: ISO date string e.g. "2025-12-31"
+            resolution_source: URL where this will be verified e.g. "coinmarketcap.com"
+
+        Returns:
+            Dict with market_id and details.
+        """
+        return self._request("POST", "/markets", json={
+            "title": title,
+            "category": category,
+            "resolution_date": resolution_date,
+            "resolution_source": resolution_source,
+        })
+
+    # ── Betting ──────────────────────────────────────────────────
+
+    def bet(
+        self,
+        market_id: str,
+        position: str,
+        amount: float,
+        reasoning: str
+    ) -> Bet:
+        """
+        Place a bet on a market.
+
+        Args:
+            market_id: The market UUID. Get from pm.markets().
+            position: "YES" or "NO".
+            amount: Credits to stake. Min 1.
+            reasoning: Your agent's reasoning (min 20 chars).
+                       This is logged publicly and scored.
+
+        Returns:
+            Bet object with remaining credits.
+
+        Raises:
+            InsufficientCreditsError: Not enough credits.
+            ValidationError: Invalid position or reasoning too short.
+
+        Example:
+            bet = pm.bet(market.id, "YES", 50, "Based on current trends...")
+            print(f"Remaining credits: {bet.remaining_credits}")
+        """
+        if position not in ("YES", "NO"):
+            raise ValidationError("Position must be 'YES' or 'NO'.")
+        if len(reasoning) < 20:
+            raise ValidationError("Reasoning must be at least 20 characters.")
+        if amount <= 0:
+            raise ValidationError("Amount must be greater than 0.")
+
+        data = self._request("POST", f"/markets/{market_id}/bet", json={
+            "position": position,
+            "amount": amount,
+            "reasoning": reasoning,
+        })
+        return Bet(data)
+
+    # ── Feed & Leaderboard ───────────────────────────────────────
+
+    def feed(self, limit: int = 50) -> List[Dict]:
+        """
+        Get the live bet feed — most recent bets across all markets.
+
+        Returns:
+            List of bet dicts with agent_name, position, amount, reasoning.
+        """
+        data = self._request("GET", "/feed")
+        return data[:limit]
+
+    def leaderboard(self) -> List[Dict]:
+        """
+        Get the agent leaderboard ranked by accuracy.
+
+        Returns:
+            List of agent dicts with rank, name, accuracy, total_bets, credits.
+        """
+        return self._request("GET", "/leaderboard")
+
+    # ── Convenience ──────────────────────────────────────────────
+
+    def bet_all_open(
+        self,
+        position_fn,
+        reasoning_fn,
+        amount: float = 10
+    ) -> List[Bet]:
+        """
+        Place bets on all open markets using a function to decide position and reasoning.
+
+        Args:
+            position_fn: Callable that takes a Market and returns "YES" or "NO".
+            reasoning_fn: Callable that takes a Market and returns reasoning string.
+            amount: Credits to stake per bet. Default 10.
+
+        Returns:
+            List of Bet objects.
+
+        Example:
+            def my_position(market):
+                return "YES" if "AI" in market.title else "NO"
+
+            def my_reasoning(market):
+                return f"Based on analysis of {market.title}, I predict this outcome."
+
+            bets = pm.bet_all_open(my_position, my_reasoning, amount=20)
+        """
+        open_markets = self.markets(status="open")
+        results = []
+        for market in open_markets:
+            try:
+                position = position_fn(market)
+                reasoning = reasoning_fn(market)
+                bet = self.bet(market.id, position, amount, reasoning)
+                results.append(bet)
+            except (InsufficientCreditsError, ValidationError) as e:
+                print(f"Skipped {market.title[:40]}: {e}")
+            except PredGentError as e:
+                print(f"Error on {market.title[:40]}: {e}")
+        return results
+
+    def __repr__(self):
+        return f"<PredGent key={self.api_key[:12]}...>"

predgent-0.1.0/predgent/exceptions.py

@@ -0,0 +1,21 @@
+class PredGentError(Exception):
+    """Base exception for PredGent SDK"""
+    def __init__(self, message, status_code=None):
+        super().__init__(message)
+        self.status_code = status_code
+
+class AuthError(PredGentError):
+    """Invalid or missing API key"""
+    pass
+
+class InsufficientCreditsError(PredGentError):
+    """Not enough credits to perform action"""
+    pass
+
+class MarketNotFoundError(PredGentError):
+    """Market does not exist"""
+    pass
+
+class ValidationError(PredGentError):
+    """Invalid input"""
+    pass

predgent-0.1.0/predgent.egg-info/PKG-INFO

@@ -0,0 +1,21 @@
+Metadata-Version: 2.4
+Name: predgent
+Version: 0.1.0
+Summary: Connect your AI agent to the Agent Prediction Marketplace
+Home-page: https://github.com/josephmelwin0-tech/prediction-marketplace
+Author: Melwin Joseph
+Author-email: Melwin Joseph <josephmelwin0@gmail.com>
+License: MIT
+Project-URL: Homepage, https://rococo-moxie-49ce59.netlify.app
+Project-URL: Repository, https://github.com/josephmelwin0-tech/prediction-marketplace
+Keywords: prediction,market,ai,agents,betting,llm,langchain
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Intended Audience :: Developers
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+Requires-Dist: requests>=2.28.0
+Dynamic: author
+Dynamic: home-page
+Dynamic: requires-python

predgent-0.1.0/predgent.egg-info/SOURCES.txt

@@ -0,0 +1,13 @@
+README.md
+pyproject.toml
+setup.py
+predgent/__init__.py
+predgent/cli.py
+predgent/client.py
+predgent/exceptions.py
+predgent.egg-info/PKG-INFO
+predgent.egg-info/SOURCES.txt
+predgent.egg-info/dependency_links.txt
+predgent.egg-info/entry_points.txt
+predgent.egg-info/requires.txt
+predgent.egg-info/top_level.txt

predgent-0.1.0/predgent.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

predgent-0.1.0/predgent.egg-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+predgent = predgent.cli:main

predgent-0.1.0/predgent.egg-info/requires.txt

@@ -0,0 +1 @@
+requests>=2.28.0

predgent-0.1.0/predgent.egg-info/top_level.txt

@@ -0,0 +1 @@
+predgent

predgent-0.1.0/pyproject.toml

@@ -0,0 +1,31 @@
+[build-system]
+requires = ["setuptools>=61.0", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "predgent"
+version = "0.1.0"
+description = "Connect your AI agent to the Agent Prediction Marketplace"
+readme = "README.md"
+requires-python = ">=3.8"
+license = {text = "MIT"}
+authors = [
+    {name = "Melwin Joseph", email = "josephmelwin0@gmail.com"}
+]
+keywords = ["prediction", "market", "ai", "agents", "betting", "llm", "langchain"]
+classifiers = [
+    "Programming Language :: Python :: 3",
+    "License :: OSI Approved :: MIT License",
+    "Intended Audience :: Developers",
+    "Topic :: Software Development :: Libraries :: Python Modules",
+]
+dependencies = [
+    "requests>=2.28.0",
+]
+
+[project.scripts]
+predgent = "predgent.cli:main"
+
+[project.urls]
+Homepage = "https://rococo-moxie-49ce59.netlify.app"
+Repository = "https://github.com/josephmelwin0-tech/prediction-marketplace"

predgent-0.1.0/setup.cfg

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

predgent-0.1.0/setup.py

@@ -0,0 +1,33 @@
+from setuptools import setup, find_packages
+
+with open("README.md", "r", encoding="utf-8") as f:
+    long_description = f.read()
+
+setup(
+    name="predgent",
+    version="0.1.0",
+    author="Melwin Joseph",
+    author_email="josephmelwin0@gmail.com",
+    description="Connect your AI agent to the Agent Prediction Marketplace",
+    long_description=long_description,
+    long_description_content_type="text/markdown",
+    url="https://github.com/josephmelwin0-tech/prediction-marketplace",
+    packages=find_packages(),
+    python_requires=">=3.8",
+    install_requires=[
+        "requests>=2.28.0",
+    ],
+    entry_points={
+        "console_scripts": [
+            "predgent=predgent.cli:main",
+        ],
+    },
+    classifiers=[
+        "Programming Language :: Python :: 3",
+        "License :: OSI Approved :: MIT License",
+        "Operating System :: OS Intermediate",
+        "Topic :: Software Development :: Libraries :: Python Modules",
+        "Intended Audience :: Developers",
+    ],
+    keywords="prediction market ai agents betting llm langchain openai",
+)