Humanos 1.0.1

Humanos SDKs

Official SDKs for the Humanos API - TypeScript/JavaScript and Python implementations with automatic request signing and webhook verification.

Available SDKs

TypeScript/JavaScript SDK

npm install humanos

📖 TypeScript Documentation

Python SDK

pip install humanos

📖 Python Documentation

Features

• 🔐 Automatic Request Signing - All API requests are automatically signed with HMAC-SHA256
• ✅ Webhook Verification - Built-in utilities for verifying webhook signatures
• 📝 Type Safety - Full TypeScript definitions and Python type hints
• 🎯 Simple API - Clean, intuitive interface for all Humanos endpoints
• 🌐 Framework Integration - Support for Express, Flask, and FastAPI
• 🔄 Auto-generated - Always up-to-date with the latest API specifications

Quick Start

TypeScript

import { HumanosClient } from "humanos";

const client = new HumanosClient({
  basePath: "https://api.humanos.id",
  apiKey: process.env.HUMANOS_API_KEY!,
  signatureSecret: process.env.HUMANOS_SIGNATURE_SECRET!,
});

const resources = await client.resources.getResources();

Python

from humanos_sdk import HumanosClient, HumanosClientConfig
import os

client = HumanosClient(HumanosClientConfig(
    base_path="https://api.humanos.id",
    api_key=os.environ["HUMANOS_API_KEY"],
    signature_secret=os.environ["HUMANOS_SIGNATURE_SECRET"],
))

resources = client.resources.get_resources()

Supported APIs

All SDKs provide access to:

• Resources API - Manage verifiable credentials and resource groups
• Requests API - Create and manage credential requests
• Users API - Create and manage users with optional KYC data
• Health API - Service health monitoring
• Webhooks - Verify and process webhook events

Documentation

• 📚 Official Documentation
• 🔗 API Reference
• 🏠 Humanos Homepage

Repository Structure

humanos-sdks/
├── typescript/          # TypeScript/JavaScript SDK
│   ├── src/            # Source code
│   ├── generated/      # Auto-generated API client
│   ├── tests/          # Test suite
│   └── README.md       # TypeScript documentation
├── python/             # Python SDK
│   ├── humanos_sdk/    # Source code
│   ├── generated/      # Auto-generated API client
│   ├── tests/          # Test suite
│   └── README.md       # Python documentation
├── .github/            # GitHub Actions workflows
└── LICENSE             # MIT License

Development

TypeScript SDK```bash

cd typescript npm install npm run build npm test

### Python SDK```bash
cd python
pip install -e ".[dev]"
pytest tests/ -v
```## Publishing### NPM (TypeScript)```bash
cd typescript
npm version patch|minor|major
npm publish
```### PyPI (Python)```bash
cd python
python -m build
twine upload dist/*
```Or use the automated GitHub Actions workflows.## Support- **Email**: support@humanos.id
- **Issues**: [GitHub Issues](https://github.com/humanos-io/humanos-sdk/issues)
- **Documentation**: [docs.humanos.id](https://docs.humanos.id)## ContributingContributions are welcome! Please feel free to submit a Pull Request.1. Fork the repository
2. Create your feature branch (`git checkout -b feature/amazing-feature`)
3. Commit your changes (`git commit -m 'Add some amazing feature'`)
4. Push to the branch (`git push origin feature/amazing-feature`)
5. Open a Pull Request## LicenseMIT License - see [LICENSE](./LICENSE) file for details.## ChangelogSee [CHANGELOG.md](./CHANGELOG.md) for a list of changes in each release.