Contributing - Grantex

Thanks for your interest in contributing. Grantex is an open protocol for delegated AI agent authorization — contributions help shape a safer agentic internet.

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 18+, Python 3.9+, Docker

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

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

# TypeScript SDK
cd packages/sdk-ts
npm install
npm run typecheck   # tsc --noEmit
npm test            # vitest

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

# Auth service
cd apps/auth-service
npm install
npm run typecheck
npm test

# Integration packages
cd packages/<package>
npm install
npm run typecheck
npm test

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

Open an issue first for anything non-trivial
One PR per concern — don’t bundle unrelated changes
Tests required — all new code needs tests
Spec changes need discussion — protocol changes require a Discussion with at least 72 hours for community input
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:

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

Questions?

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

​Where to Start

​Development Setup

​Repository Structure

​PR Guidelines

​Code Style

​Protocol Changes (RFCs)

​Questions?