tempest

KO | EN

gitlite — search

#typescript #ai-agents #ai #dsh-plugin #deepseek-harness #open-source #cli #claude-code #codex #developer-tools #react #windows

★ 97 Open GitHub ↗

Fast and secure functions to build scalable Discord Applications.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

<p align="center">
  <i align="center">Create lightning fast Discord Applications</i>
</p>

<h4 align="center">
    <a href="#features">Features</a> - <a href="#http-vs-gateway">HTTP vs Gateway</a> - <a href="#getting-started">Getting started</a> - <a href="#troubleshooting">Troubleshooting</a> - <a href="#contributing">Contributing</a>
</h4>

**Project: Tempest** is a modern, minimal [Discord](https://discord.com) library for building Discord Apps, written in [Go](https://golang.org/). It aims to be extremely fast, stay very close to the Discord API, and include little to no caching - making it an excellent choice for small VPS or serverless architecture.
In real-world projects using this library, your bottlenecks will almost always be from your database or network bandwidth, not the app or bot itself.

It was created as a better alternative to [discord-interactions-go](https://github.com/bsdlp/discord-interactions-go), which is too low-level and outdated.

### Features

- [x] Secure HTTPS-based communication with Discord's API using `crypto/ed25519`
- [x] Automatic dispatching of:
    - [x] Application commands
    - [x] Message components (buttons, select menu, text input)
    - [x] Autocomplete interactions
    - [x] Modal interactions
- [x] Built-in basic rate limit management that respects Discord’s HTTP limits
- [x] Full file upload support (message attachments) as stream (over x4 times faster than regular multipart creation)
- [x] Lightweight, fast command manager for auto handling slash commands, their auto complete and subcommands
- [x] Performance focused approach:
    - Structs only contain fields usable without a Gateway session
    - Essentially no caching for very low resource usage & easier hosting
- [x] Built-in helpers for component & modal interaction flow:
  - [Supports buttons, select menus, text inputs, and modals](https://pkg.go.dev/github.com/amatsagu/tempest#Client.AwaitComponent)
  - Includes timeout support and flexible interaction flows
  - Works with both [static](https://pkg.go.dev/github.com/amatsagu/tempest#Client.RegisterComponent) and [dynamic](https://pkg.go.dev/github.com/amatsagu/tempest#Client.AwaitModal) handlers
- [x] Support for:
    - [x] Simple messages
    - [x] Embeds
    - [x] Modals
    - [x] Bitfields (flags, permissions, etc.)
    - [x] [Components + Message Components v2](https://docs.discord.com/developers/components/overview) with full type safety
    <details>
      <summary>Supports all currently available component types</summary>

- [x] Action Row (1)
      - [x] Button (2)
      - [x] String Select (3)
      - [x] Text Input (4)
      - [x] User Select (5)
      - [x] Role Select (6)
      - [x] Mentionable Select (7)
      - [x] Channel Select (8)
      - [x] Section (9)
      - [x] Text Display (10)
      - [x] Thumbnail (11)
      - [x] Media Gallery (12)
      - [x] File (13)
      - [x] Separator (14)
      - [x] Container (17)
      - [x] Label (18)
      - [x] File Upload (19)
      - [x] Radio Group (21)
      - [x] Checkbox Group (22)
      - [x] Checkbox (23)

</details>
- [x] REST client and all API structs exposed, allowing users to easily extend library capabilities if needed
- [x] **__Basic__** support for Discord Monetization API *(enough to get started)*
- [x] **Optional** support for ws connection to gateway. Tempest focuses on HTTPS-based communication but it might be useful for large Discord Applications that require lower latency
    - [x] Support for auto-sharding (enabled by default)
    - [x] Support for zlib-stream compression (needs to be enabled in config)

### HTTP vs Gateway
**TL;DR**: you probably should be using libraries like [DiscordGo](https://github.com/bwmarrin/discordgo) unless you know why you're here.

There are two ways for bots to receive events from Discord. Most API wrappers such as **DiscordGo** use a WebSocket connection called a "gateway" to receive events, but **Tempest** receives interaction events over HTTPS\*. Using http hooks lets you scale code more easily & reduce resource usage at the cost of limiting the number of Gateway events you can use. You can easily create bots for roles, minigames, custom messages or admin utils but it'll be very difficult / impossible to create music or moderation bots.

> Since v1.4, Tempest supports handling interactions over Gateway by using `GatewayClient` instead of `HTTPClient`. The former supports most (if not all) the functionalities of the latter, so existing apps that want to switch can do so relatively easily.
> This functionality mainly exists for large Discord applications that require more reliable connections and lower latency for its users.

### Getting started
1. Install with: `go get -u github.com/amatsagu/tempest`
2. (Optional) Check the [examples folder](./example) for information on how to set up your bot.
3. Write your code and run it!

## Troubleshooting
For help or feature requests, feel free to open an issue on GitHub. \
You can also contact me on [discord](https://discord.com/users/390394829789593601).

## Contributing
See [CONTRIBUTING.md](./CONTRIBUTING.md) for guidelines on how to contribute to this project.

[![FOSSA Status](https://app.fossa.com/api/projects/git%2Bgithub.com%2FAmatsagu%2FTempest.svg?type=large)](https://app.fossa.com/projects/git%2Bgithub.com%2FAmatsagu%2FTempest?ref=badge_large)

tempest

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README