Metadata-Version: 2.4
Name: stackone-ai
Version: 0.0.3
Summary: agents performing actions on your SaaS
Author-email: StackOne <support@stackone.com>
License-File: LICENSE
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.11
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.11
Requires-Dist: langchain-core>=0.1.0
Requires-Dist: mcp[cli]>=1.3.0
Requires-Dist: pydantic>=2.10.6
Requires-Dist: requests>=2.32.3
Provides-Extra: docs
Requires-Dist: mkdocs-terminal>=4.7.0; extra == 'docs'
Requires-Dist: pygments>=2.12; extra == 'docs'
Requires-Dist: pymdown-extensions; extra == 'docs'
Provides-Extra: examples
Requires-Dist: crewai>=0.102.0; extra == 'examples'
Requires-Dist: langchain-openai>=0.3.6; extra == 'examples'
Requires-Dist: openai>=1.63.2; extra == 'examples'
Requires-Dist: python-dotenv>=1.0.1; extra == 'examples'
Description-Content-Type: text/markdown

# StackOne AI SDK

StackOne AI provides a unified interface for accessing various SaaS tools through AI-friendly APIs.

## Installation

```bash
pip install stackone-ai
```

## Quick Start

```python
from stackone_ai import StackOneToolSet

# Initialize with API key
toolset = StackOneToolSet()  # Uses STACKONE_API_KEY env var
# Or explicitly: toolset = StackOneToolSet(api_key="your-api-key")

# Get HRIS-related tools
tools = toolset.get_tools("hris_*", account_id="your-account-id")

# Use a specific tool
employee_tool = tools.get_tool("hris_get_employee")
employee = employee_tool.execute({"id": "employee-id"})
```

## Features

- Unified interface for multiple SaaS tools
- AI-friendly tool descriptions and parameters
- Integration with popular AI frameworks:
  - OpenAI Functions
  - LangChain Tools
  - CrewAI Tools
  - LangGraph Tool Node

## Documentation

For more examples and documentation, visit:

- [Error Handling](docs/error-handling.md)
- [StackOne Account IDs](docs/stackone-account-ids.md)
- [Available Tools](docs/available-tools.md)
- [File Uploads](docs/file-uploads.md)

## AI Framework Integration

- [OpenAI Integration](docs/openai-integration.md)
- [LangChain Integration](docs/langchain-integration.md)
- [CrewAI Integration](docs/crewai-integration.md)
- [LangGraph Tool Node](docs/langgraph-tool-node.md)

## License

Apache 2.0 License