mantisdk 0.1.0__tar.gz

mantisdk-0.1.0/.gitignore

@@ -0,0 +1,94 @@
+# 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/
+*.egg-info/
+.installed.cfg
+*.egg
+
+# Allow vendored GEPA library (hard fork)
+!src/mantisdk/algorithm/gepa/lib/
+!src/mantisdk/algorithm/gepa/lib/**
+
+# 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/
+
+# Translations
+*.mo
+*.pot
+
+# Environments
+.env
+.venv
+env/
+venv/
+ENV/
+env.bak/
+venv.bak/
+
+# IDE
+.idea/
+.vscode/
+*.swp
+*.swo
+*~
+
+# Jupyter Notebook
+.ipynb_checkpoints
+
+# pyenv
+.python-version
+
+# mypy
+.mypy_cache/
+.dmypy.json
+dmypy.json
+
+# Pyright
+.pyright/
+
+# OS
+.DS_Store
+Thumbs.db
+
+# Project specific
+data/
+logs/
+*.log

mantisdk-0.1.0/LICENSE

@@ -0,0 +1,19 @@
+The MIT License (MIT)
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

mantisdk-0.1.0/PKG-INFO

@@ -0,0 +1,119 @@
+Metadata-Version: 2.4
+Name: mantisdk
+Version: 0.1.0
+Summary: Mantisdk - AI Agent Training and Evaluation Platform
+Project-URL: Homepage, https://github.com/withmetis/mantis
+Project-URL: Documentation, https://withmetis.github.io/mantis/mantisdk/
+Project-URL: Repository, https://github.com/withmetis/mantis
+Project-URL: Issues, https://github.com/withmetis/mantis/issues
+Author-email: Metis Team <team@withmetis.ai>
+License: MIT
+License-File: LICENSE
+Keywords: agents,ai,evaluation,llm,mantis,observability,reinforcement-learning,training
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Requires-Python: >=3.10
+Requires-Dist: agentops>=0.4.13
+Requires-Dist: aiohttp
+Requires-Dist: aiologic
+Requires-Dist: fastapi
+Requires-Dist: flask
+Requires-Dist: gepa>=0.0.24
+Requires-Dist: gpustat
+Requires-Dist: graphviz
+Requires-Dist: gunicorn
+Requires-Dist: litellm[proxy]>=1.74
+Requires-Dist: openai
+Requires-Dist: opentelemetry-api>=1.35
+Requires-Dist: opentelemetry-exporter-otlp>=1.35
+Requires-Dist: opentelemetry-sdk>=1.35
+Requires-Dist: portpicker
+Requires-Dist: psutil
+Requires-Dist: pydantic>=2.11
+Requires-Dist: rich
+Requires-Dist: setproctitle
+Requires-Dist: uvicorn
+Requires-Dist: uvicorn-worker
+Provides-Extra: apo
+Requires-Dist: poml; extra == 'apo'
+Provides-Extra: mongo
+Requires-Dist: pymongo; extra == 'mongo'
+Provides-Extra: verl
+Requires-Dist: verl>=0.5.0; extra == 'verl'
+Requires-Dist: vllm>=0.8.4; extra == 'verl'
+Provides-Extra: weave
+Requires-Dist: weave>=0.52.22; extra == 'weave'
+Description-Content-Type: text/markdown
+
+# Mantisdk
+
+[![PyPI version](https://badge.fury.io/py/mantisdk.svg)](https://badge.fury.io/py/mantisdk)
+[![License](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
+
+**AI Agent Training and Evaluation Platform**
+
+Mantisdk is a comprehensive toolkit for training and evaluating AI agents using reinforcement learning, automatic prompt optimization, and supervised fine-tuning.
+
+## Core Features
+
+- Turn your agent into an optimizable beast with **minimal code changes**
+- Build with **any** agent framework (LangChain, OpenAI Agent SDK, AutoGen, CrewAI, and more)
+- **Selectively** optimize one or more agents in a multi-agent system
+- Embraces **algorithms** like Reinforcement Learning, Automatic Prompt Optimization, Supervised Fine-tuning and more
+
+## Installation
+
+```bash
+pip install mantisdk
+```
+
+For optional dependencies:
+
+```bash
+# For APO (Automatic Prompt Optimization)
+pip install mantisdk[apo]
+
+# For VERL integration
+pip install mantisdk[verl]
+
+# For Weave integration
+pip install mantisdk[weave]
+
+# For MongoDB store
+pip install mantisdk[mongo]
+```
+
+## Quick Start
+
+```python
+import mantisdk as msk
+
+# Initialize the client
+client = msk.MantisdkClient()
+
+# Your agent code here...
+```
+
+## CLI Usage
+
+```bash
+# Start the Mantisdk server
+msk store serve
+
+# Run with vLLM
+msk vllm start
+```
+
+## Documentation
+
+For full documentation, visit [https://withmetis.github.io/mantis/mantisdk/](https://withmetis.github.io/mantis/mantisdk/)
+
+## License
+
+MIT License - see [LICENSE](LICENSE) for details.

mantisdk-0.1.0/PUBLISHING.md

@@ -0,0 +1,95 @@
+# Publishing Mantisdk to PyPI
+
+This document describes how to set up and publish the Mantisdk package to PyPI.
+
+Mantisdk is part of the Mantis monorepo and is published from `mantisdk/sdk/`.
+
+## Prerequisites
+
+1. A PyPI account (https://pypi.org/account/register/)
+2. A TestPyPI account (https://test.pypi.org/account/register/)
+3. The package built and ready to publish
+
+## Setting Up Trusted Publishing (Recommended)
+
+Trusted publishing uses OpenID Connect (OIDC) to authenticate with PyPI without needing API tokens.
+
+### Step 1: Reserve the Package Name on PyPI
+
+1. Go to https://pypi.org/manage/account/publishing/
+2. Click "Add a new pending publisher"
+3. Fill in the details:
+   - **PyPI Project Name**: `mantisdk`
+   - **Owner**: Your GitHub organization or username (e.g., `withmetis`)
+   - **Repository name**: `mantis`
+   - **Workflow name**: `mantisdk-pypi-release.yml`
+   - **Environment name**: (leave blank or use `release`)
+4. Click "Add"
+
+### Step 2: Set Up TestPyPI (Optional but Recommended)
+
+1. Go to https://test.pypi.org/manage/account/publishing/
+2. Follow the same steps as above for TestPyPI (use `mantisdk-pypi-nightly.yml`)
+
+### Step 3: Verify GitHub Actions
+
+The workflows are configured in the mantis repo root `.github/workflows/`:
+
+- `mantisdk-pypi-release.yml` - Publishes to PyPI when you push a tag like `mantisdk-v0.1.0`
+- `mantisdk-pypi-nightly.yml` - Publishes nightly builds to TestPyPI
+- `mantisdk-test.yml` - Runs tests on changes to `mantisdk/sdk/`
+
+## Manual Publishing (Alternative)
+
+If you need to publish manually:
+
+```bash
+# Install build tools
+pip install build twine
+
+# Build the package
+python -m build
+
+# Upload to TestPyPI first
+python -m twine upload --repository testpypi dist/*
+
+# Test installation from TestPyPI
+pip install --index-url https://test.pypi.org/simple/ \
+    --extra-index-url https://pypi.org/simple/ mantisdk
+
+# Upload to PyPI
+python -m twine upload dist/*
+```
+
+## Releasing a New Version
+
+1. Update the version in `mantisdk/sdk/pyproject.toml` and `mantisdk/sdk/src/mantisdk/__init__.py`
+2. Commit the changes
+3. Create and push a version tag (note the `mantisdk-` prefix):
+   ```bash
+   git tag mantisdk-v0.1.0
+   git push origin mantisdk-v0.1.0
+   ```
+4. GitHub Actions will automatically build and publish to PyPI
+
+## Version Numbering
+
+We follow semantic versioning (SemVer):
+
+- **MAJOR.MINOR.PATCH** (e.g., `0.1.0`)
+- Increment MAJOR for breaking changes
+- Increment MINOR for new features
+- Increment PATCH for bug fixes
+
+## Troubleshooting
+
+### "Project not found" error
+
+Make sure you've set up the pending publisher on PyPI before pushing the first release tag.
+
+### "Authentication failed" error
+
+Verify that:
+1. The workflow file name matches what you configured on PyPI
+2. The repository owner/name matches
+3. The `id-token: write` permission is set in the workflow

mantisdk-0.1.0/README.md

@@ -0,0 +1,66 @@
+# Mantisdk
+
+[![PyPI version](https://badge.fury.io/py/mantisdk.svg)](https://badge.fury.io/py/mantisdk)
+[![License](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
+
+**AI Agent Training and Evaluation Platform**
+
+Mantisdk is a comprehensive toolkit for training and evaluating AI agents using reinforcement learning, automatic prompt optimization, and supervised fine-tuning.
+
+## Core Features
+
+- Turn your agent into an optimizable beast with **minimal code changes**
+- Build with **any** agent framework (LangChain, OpenAI Agent SDK, AutoGen, CrewAI, and more)
+- **Selectively** optimize one or more agents in a multi-agent system
+- Embraces **algorithms** like Reinforcement Learning, Automatic Prompt Optimization, Supervised Fine-tuning and more
+
+## Installation
+
+```bash
+pip install mantisdk
+```
+
+For optional dependencies:
+
+```bash
+# For APO (Automatic Prompt Optimization)
+pip install mantisdk[apo]
+
+# For VERL integration
+pip install mantisdk[verl]
+
+# For Weave integration
+pip install mantisdk[weave]
+
+# For MongoDB store
+pip install mantisdk[mongo]
+```
+
+## Quick Start
+
+```python
+import mantisdk as msk
+
+# Initialize the client
+client = msk.MantisdkClient()
+
+# Your agent code here...
+```
+
+## CLI Usage
+
+```bash
+# Start the Mantisdk server
+msk store serve
+
+# Run with vLLM
+msk vllm start
+```
+
+## Documentation
+
+For full documentation, visit [https://withmetis.github.io/mantis/mantisdk/](https://withmetis.github.io/mantis/mantisdk/)
+
+## License
+
+MIT License - see [LICENSE](LICENSE) for details.