Contributing

How to contribute to the Grantex project.

Thanks for your interest in contributing. Grantex is a published, source-available protocol for delegated AI agent authorization — contributions help shape a safer agentic internet.

Contribution licence

The Grantex SDKs and client packages are Apache-2.0; the server, portal and documentation are under the Orchestrum Personal Use License 1.0, under which Orchestrum Technologies LLP also licenses organisations by written agreement (see the Licence page). By submitting a contribution you agree to the contribution licence in CONTRIBUTING.md: you keep your copyright and grant Orchestrum Technologies LLP a perpetual, irrevocable licence to distribute and license the contribution on any terms, including agreements with organisations.

Where to Start

Area	What’s needed	Skill
New integrations	Add Grantex support to more frameworks	TypeScript / Python
Examples & tutorials	End-to-end walkthroughs for common use cases	Writing
Bug reports	Found a bug? Open an issue with reproduction steps	Any
Protocol feedback	Review SPEC.md, open issues for gaps	Any
Docs	Improve quickstart, add translations	Writing

Look for issues tagged good first issue.

Development Setup

# Prerequisites: Node.js 24 LTS, Python 3.9+, Docker

git clone https://github.com/mishrasanjeev/grantex
cd grantex

# Start the full local stack
docker compose up --build -d

# TypeScript SDK
npm --prefix packages/sdk-ts ci
npm --prefix packages/sdk-ts run typecheck
npm --prefix packages/sdk-ts test
npm --prefix packages/sdk-ts run build

# Python SDK
cd packages/sdk-py
pip install -e ".[dev]"
pytest
cd ../..

# Auth service
npm --prefix apps/auth-service ci
npm --prefix apps/auth-service run typecheck
npm --prefix apps/auth-service test

# Integration packages
npm --prefix packages/langchain ci
npm --prefix packages/langchain run typecheck
npm --prefix packages/langchain test

For real PostgreSQL audit tests, complete Docker E2E checks and upgrade gates, see Dependency Updates and Validation.

Repository Structure

grantex/
├── SPEC.md                       ← Protocol specification (v1.0 final)
├── packages/
│   ├── sdk-ts/                   ← TypeScript SDK (@grantex/sdk)
│   ├── sdk-py/                   ← Python SDK (grantex)
│   ├── langchain/                ← LangChain integration
│   ├── autogen/                  ← AutoGen / OpenAI integration
│   ├── vercel-ai/                ← Vercel AI SDK integration
│   ├── crewai/                   ← CrewAI integration
│   ├── openai-agents/            ← OpenAI Agents SDK integration
│   ├── google-adk/               ← Google ADK integration
│   ├── mcp/                      ← MCP server
│   └── cli/                      ← CLI tool
├── apps/
│   ├── auth-service/             ← Fastify auth service
│   └── portal/                   ← Developer portal (React)
├── examples/                     ← Runnable examples
├── deploy/                       ← Docker, Helm, Nginx configs
└── docs/                         ← This docs site

PR Guidelines

1. Open an issue first for anything non-trivial
2. One PR per concern — don’t bundle unrelated changes
3. Tests required — all new code needs tests
4. Spec changes need discussion — protocol changes require a Discussion with at least 72 hours for community input
5. Changelog entry — add a line to CHANGELOG.md under Unreleased

Code Style

• TypeScript: ESLint + Prettier
• Python: Ruff + Black
• Commits: Conventional Commits (feat:, fix:, docs:, spec:)

Protocol Changes (RFCs)

Changes to SPEC.md follow a lightweight RFC process:

1. Open a GitHub Discussion tagged [RFC]
2. Describe the change, motivation, and alternatives
3. 72-hour minimum comment period
4. Maintainer merges or closes with reasoning

Questions?

• GitHub Discussions for design questions
• GitHub Issues for bugs and feature requests
• Discord for real-time chat

Ownership

Grantex is owned by Orchestrum Technologies LLP. Inventor and owner: Sanjeev Kumar. Ownership contact: [e-mail] or [e-mail].