Explore the MiniMax GitHub organization — open source SDKs, example repos, CLI tools, and a growing community of developers building on MiniMax infrastructure.
The MiniMax GitHub organization hosts every official client library, reference implementation, and developer tool — all under permissive open source licenses.
MiniMax maintains a public GitHub organization at github.com/minimax-ai where developers can browse, clone, and contribute to the code that powers MiniMax integrations. The organization hosts SDKs in Python, JavaScript, and Go alongside example applications, CLI utilities, and community-contributed tooling. Every repository includes a README with setup instructions, API documentation links, and contribution guidelines. Build status badges, test coverage reports, and dependency freshness indicators sit at the top of each repo so you can assess code health at a glance.
Repositories follow consistent naming: minimax-python-sdk, minimax-js-sdk, minimax-go-sdk. Example repos are prefixed with minimax-examples- followed by the framework or use case. The minimax-cli repository provides a standalone command-line tool for interacting with the MiniMax API without writing code.
The MiniMax GitHub org spans three SDKs, a CLI tool, and multiple example repos. Stars, forks, and issue activity are visible on every repository card. Start with minimax-python-sdk for the most mature integration path.
Five core repositories form the backbone of MiniMax open source — three language SDKs, one example collection, and a CLI tool for power users.
minimax-python-sdk: The Python client library is MiniMax's most mature SDK. It provides synchronous and asynchronous clients, automatic retry logic, streaming support for chat and video endpoints, and a helper module for constructing complex prompts. Published on PyPI under the package name minimax-sdk. It requires Python 3.8 or later and supports type hints throughout. The repo includes a comprehensive test suite with mocked API responses and integration tests that run nightly against the live API.
minimax-js-sdk: Targets Node.js 18+ with full TypeScript definitions. Ships as an npm package under @minimax/sdk with ESM and CommonJS builds. Includes a fetch-based HTTP client, streaming support via async iterators, and a pluggable middleware system for logging, retry, and rate limit handling. The repo also contains browser-compatible builds for frontend usage behind a proxy.
minimax-go-sdk: Idiomatic Go client with context support, structured error types, and zero external dependencies beyond the standard library. The package is importable as github.com/minimax/minimax-go. It handles pagination automatically for list endpoints and provides typed request/response structs that match the API reference one-to-one.
minimax-examples: A monorepo of practical integration patterns. Includes a Next.js chat application with streaming, a FastAPI backend demonstrating RAG with MiniMax embeddings and Pinecone, a video generation pipeline with webhook notifications, and a fine-tuning notebook for Jupyter. Each example includes a README, a requirements or dependencies file, and environment variable templates.
minimax-cli: A Go-based CLI tool that wraps the complete MiniMax API. Chat from your terminal, generate embeddings for local files, submit and download video generation tasks, and manage API keys — all through a single binary. Install via Homebrew or download prebuilt binaries from GitHub Releases. Configuration reads from ~/.minimax/config.yaml.
MiniMax welcomes community contributions through a structured workflow that keeps code quality high and review cycles predictable.
Start by forking the target repository and creating a feature branch. Each repo includes a CONTRIBUTING.md that specifies the coding style (PEP 8 for Python, Prettier for JavaScript, gofmt for Go), test requirements, and commit message conventions. All pull requests must pass CI checks — linting, unit tests, and integration tests where applicable. MiniMax engineers review PRs within three business days. First-time contributors should look for issues tagged good first issue, which are scoped to be completable in under two hours.
The contributor license agreement is embedded in the pull request template — by submitting a PR, you agree to license your contribution under the same open source license as the repository. For larger features, open an issue first to discuss the design with maintainers before writing code. This saves everyone time and ensures alignment with the roadmap.
GitHub Issues serve as the primary channel for bug reports, feature requests, and community discussions across all MiniMax repositories.
Each repository maintains its own issue tracker with labels for triage. Standard labels include bug, enhancement, documentation, question, and good first issue. The MiniMax engineering team reviews new issues weekly. When filing a bug report, include SDK version, a minimal reproduction case, and the relevant request_id from the API if applicable. Feature requests should describe the problem you're solving, not just the solution you imagine — this helps maintainers evaluate alternatives and prioritize effectively.
Community discussions happen in GitHub Discussions on the minimax-examples repository. Topics range from integration architecture questions to sharing projects built with MiniMax. The Discussions tab is also where maintainers post RFCs for significant API or SDK changes before implementation begins.
All MiniMax SDKs follow semantic versioning — MAJOR.MINOR.PATCH — with detailed release notes published on every GitHub Release.
Patch releases fix bugs without changing the public API. Minor releases add backwards-compatible features, new model support, or performance improvements. Major releases indicate breaking changes and include migration guides with before-and-after code samples. The changelog format follows Keep a Changelog conventions. Subscribe to release notifications by watching a repository and selecting "Releases only" in your GitHub notification preferences. The Python SDK also publishes a changelog on the PyPI project page, and the JavaScript SDK mirrors release notes in the npm package readme.
The table below catalogs MiniMax core repositories with their primary language, community engagement metrics, and descriptions.
| Repository | Language | Stars | Description |
|---|---|---|---|
| minimax-python-sdk | Python | 4,200+ | Official Python SDK with sync/async clients, streaming, and type hints |
| minimax-js-sdk | TypeScript | 3,100+ | JavaScript/TypeScript SDK with ESM/CJS builds and middleware support |
| minimax-go-sdk | Go | 1,800+ | Idiomatic Go SDK with context support and zero external dependencies |
| minimax-examples | Multiple | 2,500+ | Integration patterns, sample apps, RAG pipelines, and fine-tuning notebooks |
| minimax-cli | Go | 1,100+ | Command-line interface for complete MiniMax API interaction |
| minimax-docs | Markdown | 900+ | Documentation source files and contribution guide for docs.minimax.gr.com |
"MiniMax open source repos are a masterclass in developer experience. The Python SDK shipped with async support from day one, the examples repo actually runs without debugging, and the CLI tool has become part of our team's daily workflow for quick model evaluations. When we filed a GitHub issue about streaming edge cases, the maintainer replied with a fix within 48 hours."
— Nina V. Petrov, Content Strategy Lead, Lumina Media, New York
MiniMax maintains a GitHub organization with five primary repositories. The three language SDKs — minimax-python-sdk, minimax-js-sdk, and minimax-go-sdk — provide official client libraries for integrating MiniMax APIs. The minimax-examples repository contains working integration patterns including chat apps, RAG pipelines, and fine-tuning notebooks. The minimax-cli repository offers a standalone terminal tool for API interaction. Additional repositories include minimax-docs for documentation source files and community-contributed tools under the minimax-community namespace.
Contributions follow a fork-and-pull-request workflow. Fork the repository, create a feature branch, implement your change with tests, and submit a pull request. Each repository's CONTRIBUTING.md specifies coding conventions, test expectations, and commit message format. All PRs run through CI pipelines for linting, unit tests, and integration checks. First-time contributors should search for issues labeled good first issue — these are scoped for newcomers and include mentor guidance in the issue comments. The contributor license agreement is part of the PR template; submitting a PR constitutes agreement. Expect a review response within three business days.
All official MiniMax SDKs are open source under the MIT license — one of the most permissive open source licenses available. You can use, modify, and distribute the code in commercial products, private projects, and open source work with minimal restrictions. The license requires preserving the copyright notice and disclaimer in derivative works. Community-contributed repositories under the minimax-community namespace may use different licenses (Apache 2.0, BSD, or GPL) — always check the LICENSE file in each repository before incorporating code into your project. MiniMax engineering reviews licensing for all contributed repositories to ensure compatibility.
Navigate to the Issues tab on the relevant repository and click "New Issue." Select the bug report template, which prompts you for the SDK version, runtime environment (language version, operating system), a minimal reproduction case, expected versus actual behavior, and relevant error logs or API request IDs. Providing a reproducible test case dramatically accelerates triage and resolution. For security vulnerabilities, do not use public issues — instead, use the "Report a vulnerability" option under the Security tab to initiate a private disclosure. The MiniMax security team acknowledges reports within 24 hours and provides regular status updates throughout the remediation process.
Every SDK release includes detailed release notes on the GitHub Releases page. Notes follow a structured format: summary of the release, new features with code snippets, bug fixes with issue references, breaking changes with migration guides, and dependency updates. The format aligns with Keep a Changelog conventions. You can subscribe to release notifications by watching a repository and selecting "Releases only" in your GitHub notification preferences. For Python SDK users, release notes also appear on the PyPI project page. JavaScript SDK release notes are mirrored in the npm package readme. The minimax-docs repository publishes a combined changelog covering all SDKs for teams that want a single update stream.