dojozero 0.1.0__tar.gz → 0.2.0__tar.gz

dojozero-0.2.0/.gitignore

@@ -0,0 +1,175 @@
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]
+*$py.class
+
+# C extensions
+*.so
+
+# Distribution / packaging
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+share/python-wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+
+# PyInstaller
+*.manifest
+*.spec
+
+# Installer logs
+pip-log.txt
+pip-delete-this-directory.txt
+
+# Unit test / coverage reports
+htmlcov/
+.tox/
+.nox/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+*.cover
+*.py,cover
+.hypothesis/
+.pytest_cache/
+cover/
+
+# Translations
+*.mo
+*.pot
+
+# Django stuff:
+*.log
+local_settings.py
+db.sqlite3
+db.sqlite3-journal
+
+# Flask stuff:
+instance/
+.webassets-cache
+
+# Scrapy stuff:
+.scrapy
+
+# Sphinx documentation
+docs/_build/
+
+# PyBuilder
+.pybuilder/
+target/
+
+# Jupyter Notebook
+.ipynb_checkpoints
+
+# IPython
+profile_default/
+ipython_config.py
+
+# pyenv
+.python-version
+
+# pipenv
+Pipfile.lock
+
+# poetry
+poetry.lock
+
+# pdm
+.pdm.toml
+
+# PEP 582
+__pypackages__/
+
+# Celery stuff
+celerybeat-schedule
+celerybeat.pid
+
+# SageMath parsed files
+*.sage.py
+
+# Environments
+.env
+.env.prod
+.env.dev
+.env.test
+.env.local
+.env.*.local
+
+# virtualenvs
+.venv
+env/
+venv/
+ENV/
+env.bak/
+venv.bak/
+
+# Spyder project settings
+.spyderproject
+.spyproject
+
+# Rope project settings
+.ropeproject
+
+# mkdocs documentation
+/site
+
+# mypy
+.mypy_cache/
+.dmypy.json
+dmypy.json
+
+# Pyre type checker
+.pyre/
+
+# pytype static type analyzer
+.pytype/
+
+# Cython debug symbols
+cython_debug/
+
+# UV
+.uv/
+uv.lock
+
+# IDEs
+.vscode/
+.idea/
+*.swp
+*.swo
+*~
+
+# OS
+.DS_Store
+Thumbs.db
+
+# Sample scenario artifacts
+dojozero-store
+
+# Data
+/outputs/
+/data/
+
+# Claude configs 
+/.claude/
+
+# Package lock files
+package-lock.json
+
+# logs
+/logs/node_modules/
+node_modules/

dojozero-0.2.0/PKG-INFO

@@ -0,0 +1,135 @@
+Metadata-Version: 2.4
+Name: dojozero
+Version: 0.2.0
+Summary: A platform for running AI agents on realtime sport data and make predictions about game outcomes.
+Project-URL: Homepage, https://github.com/agentscope-ai/DojoZero
+Project-URL: Repository, https://github.com/agentscope-ai/DojoZero
+Project-URL: Issues, https://github.com/agentscope-ai/DojoZero/issues
+Author-email: DojoZero Team <dojozero@list.alibaba-inc.com>
+License: MIT
+Keywords: ai-agents,prediction,realtime,sports,trading
+Classifier: Development Status :: 3 - Alpha
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Requires-Python: >=3.11
+Requires-Dist: agentscope[gemini]>=1.0.14
+Requires-Dist: aiohttp>=3.9.0
+Requires-Dist: dashscope>=1.0.0
+Requires-Dist: fastapi>=0.128.0
+Requires-Dist: httpx>=0.28.0
+Requires-Dist: matplotlib>=3.10.8
+Requires-Dist: opentelemetry-api>=1.29.0
+Requires-Dist: opentelemetry-exporter-otlp-proto-http>=1.29.0
+Requires-Dist: opentelemetry-sdk>=1.29.0
+Requires-Dist: py-clob-client>=0.1.0
+Requires-Dist: pydantic>=2.12.4
+Requires-Dist: python-dotenv>=1.2.1
+Requires-Dist: pyyaml>=6.0
+Requires-Dist: tavily-python>=0.7.12
+Requires-Dist: uvicorn>=0.40.0
+Requires-Dist: xdk>=0.9.0
+Provides-Extra: alicloud
+Requires-Dist: alibabacloud-credentials>=1.0.0; extra == 'alicloud'
+Requires-Dist: aliyun-log-python-sdk; extra == 'alicloud'
+Requires-Dist: oss2>=2.18.0; extra == 'alicloud'
+Provides-Extra: ray
+Requires-Dist: ray>=2.51.1; extra == 'ray'
+Provides-Extra: redis
+Requires-Dist: redis>=7.2.1; extra == 'redis'
+Description-Content-Type: text/markdown
+
+# DojoZero
+
+A platform for running AI agents on realtime sport data and make predictions about game outcomes.
+
+## Installation
+
+```bash
+pip install dojozero
+```
+
+### Optional extras
+
+```bash
+pip install dojozero[alicloud]   # Alibaba Cloud integration (OSS, credentials, SLS)
+pip install dojozero[redis]      # Redis-backed data stores
+pip install dojozero[ray]        # Distributed execution via Ray
+```
+
+## Environment Setup
+
+```bash
+cp .env.example .env
+```
+
+## Quick Start
+
+### Run a single trial locally
+
+```bash
+dojo0 run --params trial_params/nba-moneyline.yaml --trial-id nba-local-001
+```
+
+### Resume an interrupted trial
+
+```bash
+dojo0 run --trial-id nba-local-001 --resume-latest
+```
+
+### Run through dashboard server
+
+```bash
+# Start server with tracing
+dojo0 serve --trace-backend jaeger
+
+# Submit a trial from another terminal
+dojo0 run \
+  --params trial_params/nba-moneyline.yaml \
+  --trial-id nba-server-001 \
+  --server http://localhost:8000
+```
+
+### Automatic scheduling with trial sources
+
+```bash
+dojo0 serve --trace-backend jaeger --trial-source "trial_sources/daily/*.yaml"
+```
+
+### Backtest from captured events
+
+```bash
+dojo0 backtest \
+  --events outputs/2026-01-12/401772976.jsonl \
+  --params outputs/2026-01-12/401772976.yaml \
+  --speed 100 --max-sleep 1
+```
+
+### Arena (live visualization)
+
+```bash
+dojo0 arena --trace-backend jaeger
+```
+
+## Command Index
+
+| Command | Purpose |
+|---------|---------|
+| `dojo0 run` | Start a local or server-submitted trial |
+| `dojo0 serve` | Dashboard / orchestration server |
+| `dojo0 arena` | Trace-backed Arena visualization server |
+| `dojo0 backtest` | Replay persisted event streams |
+| `dojo0 list-sources` | List trial sources |
+| `dojo0 list-trials` | List scheduled trials |
+| `dojo0 clear-schedules` | Clear scheduled runs |
+
+## Documentation
+
+- [Documentation](https://github.com/agentscope-ai/DojoZero/docs/README.md)
+
+## License
+
+MIT

dojozero-0.2.0/README.md

@@ -0,0 +1,91 @@
+# DojoZero
+
+A platform for running AI agents on realtime sport data and make predictions about game outcomes.
+
+## Installation
+
+```bash
+pip install dojozero
+```
+
+### Optional extras
+
+```bash
+pip install dojozero[alicloud]   # Alibaba Cloud integration (OSS, credentials, SLS)
+pip install dojozero[redis]      # Redis-backed data stores
+pip install dojozero[ray]        # Distributed execution via Ray
+```
+
+## Environment Setup
+
+```bash
+cp .env.example .env
+```
+
+## Quick Start
+
+### Run a single trial locally
+
+```bash
+dojo0 run --params trial_params/nba-moneyline.yaml --trial-id nba-local-001
+```
+
+### Resume an interrupted trial
+
+```bash
+dojo0 run --trial-id nba-local-001 --resume-latest
+```
+
+### Run through dashboard server
+
+```bash
+# Start server with tracing
+dojo0 serve --trace-backend jaeger
+
+# Submit a trial from another terminal
+dojo0 run \
+  --params trial_params/nba-moneyline.yaml \
+  --trial-id nba-server-001 \
+  --server http://localhost:8000
+```
+
+### Automatic scheduling with trial sources
+
+```bash
+dojo0 serve --trace-backend jaeger --trial-source "trial_sources/daily/*.yaml"
+```
+
+### Backtest from captured events
+
+```bash
+dojo0 backtest \
+  --events outputs/2026-01-12/401772976.jsonl \
+  --params outputs/2026-01-12/401772976.yaml \
+  --speed 100 --max-sleep 1
+```
+
+### Arena (live visualization)
+
+```bash
+dojo0 arena --trace-backend jaeger
+```
+
+## Command Index
+
+| Command | Purpose |
+|---------|---------|
+| `dojo0 run` | Start a local or server-submitted trial |
+| `dojo0 serve` | Dashboard / orchestration server |
+| `dojo0 arena` | Trace-backed Arena visualization server |
+| `dojo0 backtest` | Replay persisted event streams |
+| `dojo0 list-sources` | List trial sources |
+| `dojo0 list-trials` | List scheduled trials |
+| `dojo0 clear-schedules` | Clear scheduled runs |
+
+## Documentation
+
+- [Documentation](https://github.com/agentscope-ai/DojoZero/docs/README.md)
+
+## License
+
+MIT

dojozero-0.2.0/pyproject.toml

@@ -0,0 +1,63 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "dojozero"
+version = "0.2.0"
+description = "A platform for running AI agents on realtime sport data and make predictions about game outcomes."
+readme = "README.md"
+requires-python = ">=3.11"
+license = {text = "MIT"}
+authors = [
+    {name = "DojoZero Team", email = "dojozero@list.alibaba-inc.com"}
+]
+keywords = ["ai-agents", "sports", "realtime", "prediction", "trading"]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Topic :: Scientific/Engineering :: Artificial Intelligence",
+]
+dependencies = [
+    "PyYAML>=6.0",
+    "pydantic>=2.12.4",
+    "aiohttp>=3.9.0",
+    "agentscope[gemini]>=1.0.14",
+    "py-clob-client>=0.1.0",
+    "fastapi>=0.128.0",
+    "uvicorn>=0.40.0",
+    "httpx>=0.28.0",
+    "opentelemetry-api>=1.29.0",
+    "opentelemetry-sdk>=1.29.0",
+    "opentelemetry-exporter-otlp-proto-http>=1.29.0",
+    "matplotlib>=3.10.8",
+    "python-dotenv>=1.2.1",
+    "tavily-python>=0.7.12",
+    "dashscope>=1.0.0",
+    "xdk>=0.9.0",
+]
+
+[project.urls]
+Homepage = "https://github.com/agentscope-ai/DojoZero"
+Repository = "https://github.com/agentscope-ai/DojoZero"
+Issues = "https://github.com/agentscope-ai/DojoZero/issues"
+
+[project.scripts]
+dojo0 = "dojozero.cli:main"
+
+[project.optional-dependencies]
+ray = [
+    "ray>=2.51.1",
+]
+alicloud = [
+    "oss2>=2.18.0",
+    "alibabacloud-credentials>=1.0.0",
+    "aliyun-log-python-sdk",
+]
+redis = [
+    "redis>=7.2.1",
+]

dojozero-0.2.0/src/dojozero/__init__.py

@@ -0,0 +1,13 @@
+"""
+DojoZero package.
+"""
+
+import importlib.metadata
+from typing import Final
+
+try:
+    _version = importlib.metadata.version(__name__)
+except importlib.metadata.PackageNotFoundError:
+    _version = "0.0.0"  # Fallback for development mode
+__version__: Final[str] = _version
+__author__ = "DojoZero Team"

dojozero-0.2.0/src/dojozero/_optional_alicloud.py

@@ -0,0 +1,44 @@
+"""Runtime checks for optional Alibaba Cloud-related wheels.
+
+Base install (`pip install dojozero`) omits OSS/SLS/credentials SDKs.
+Use `pip install 'dojozero[alicloud]'` for those features.
+"""
+
+from __future__ import annotations
+
+INSTALL_ALICLOUD = "pip install 'dojozero[alicloud]'"
+
+
+def ensure_alibabacloud_credentials() -> None:
+    """Raise ImportError if alibabacloud-credentials is not installed."""
+    try:
+        from alibabacloud_credentials.client import Client  # noqa: F401
+    except ImportError as e:
+        raise ImportError(
+            f"Missing alibabacloud-credentials (needed for SLS trace export). "
+            f"Install with: {INSTALL_ALICLOUD}"
+        ) from e
+
+
+def ensure_oss2() -> None:
+    """Raise ImportError if oss2 is not installed."""
+    try:
+        import oss2  # noqa: F401
+    except ImportError as e:
+        raise ImportError(
+            f"Missing oss2 (needed for OSS backup and oss:// paths). "
+            f"Install with: {INSTALL_ALICLOUD}"
+        ) from e
+
+
+INSTALL_REDIS = "pip install 'dojozero[redis]'"
+
+
+def ensure_redis() -> None:
+    """Raise ImportError if redis is not installed."""
+    try:
+        import redis  # noqa: F401
+    except ImportError as e:
+        raise ImportError(
+            f"Missing redis package (needed for sync-service). Install with: {INSTALL_REDIS}"
+        ) from e

dojozero-0.2.0/src/dojozero/agents/__init__.py

@@ -0,0 +1,64 @@
+"""Agent configuration and utilities for DojoZero."""
+
+from ._config import (
+    load_agent_config,
+    load_persona_config,
+    load_llm_file_config,
+    AgentConfig,
+    SingleModelAgentConfig,
+    LLMConfig,
+    PersonaConfig,
+    LLMFileConfig,
+    create_model,
+    create_formatter,
+    expand_agent_config,
+    filter_llm_configs_by_credentials,
+    llm_config_has_credentials,
+)
+from ._toolkit import create_toolkit, tool
+from ._social_board import (
+    HotTopicsEvent,
+    SocialBoard,
+    SocialMessage,
+    create_social_board_tools,
+    format_hot_topics_for_llm,
+    SocialBoardActor,
+    SocialBoardConfig,
+)
+from ._trial_utils import (
+    get_expanded_agent_ids,
+    build_operator_to_agents_map,
+    build_agent_specs,
+    load_agent_configs_cached,
+)
+
+__all__ = [
+    "load_agent_config",
+    "load_persona_config",
+    "load_llm_file_config",
+    "AgentConfig",
+    "SingleModelAgentConfig",
+    "LLMConfig",
+    "PersonaConfig",
+    "LLMFileConfig",
+    "create_toolkit",
+    "create_model",
+    "create_formatter",
+    "expand_agent_config",
+    "filter_llm_configs_by_credentials",
+    "llm_config_has_credentials",
+    "tool",
+    # Social board (multi-agent communication)
+    "HotTopicsEvent",
+    "SocialBoard",
+    "SocialMessage",
+    "create_social_board_tools",
+    "format_hot_topics_for_llm",
+    "SocialBoardActor",
+    "SocialBoardConfig",
+    # Trial utilities
+    "get_expanded_agent_ids",
+    "build_operator_to_agents_map",
+    "build_agent_specs",
+    "load_agent_configs_cached",
+]