Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/tailcallhq/tailcall
High Performance GraphQL Runtime
https://github.com/tailcallhq/tailcall
api-gateway backend-for-frontend battle-tested cloud-native extendable graphql graphql-api graphql-server io-efficiency microservices open-source orchestration performance protocol-agnostic proxy resiliency runtime-tuning seamless-devx security
Last synced: 28 days ago
JSON representation
High Performance GraphQL Runtime
- Host: GitHub
- URL: https://github.com/tailcallhq/tailcall
- Owner: tailcallhq
- License: apache-2.0
- Created: 2023-01-06T10:38:37.000Z (almost 2 years ago)
- Default Branch: main
- Last Pushed: 2024-10-12T21:14:07.000Z (28 days ago)
- Last Synced: 2024-10-13T04:02:47.300Z (28 days ago)
- Topics: api-gateway, backend-for-frontend, battle-tested, cloud-native, extendable, graphql, graphql-api, graphql-server, io-efficiency, microservices, open-source, orchestration, performance, protocol-agnostic, proxy, resiliency, runtime-tuning, seamless-devx, security
- Language: Rust
- Homepage: https://tailcall.run
- Size: 23.7 MB
- Stars: 1,281
- Watchers: 7
- Forks: 249
- Open Issues: 64
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
Awesome Lists containing this project
README
[![Tailcall Logo](https://raw.githubusercontent.com/tailcallhq/tailcall/main/assets/logo_main.svg)](https://tailcall.run)
Tailcall is an open-source solution for building [high-performance] GraphQL backends.
Please support us by giving the repository a star
![image](https://raw.githubusercontent.com/tailcallhq/tailcall/main/assets/star-our-repo.gif)[high-performance]: https://github.com/tailcallhq/graphql-benchmarks
[![Tweet](https://img.shields.io/twitter/url/http/shields.io.svg?style=for-the-badge&logo=x&color=black&labelColor=black)](https://twitter.com/intent/tweet?text=%40tailcallhq%20is%20building%20a%20high-performance%20API%20Orchestration%20solution%20over%20%23GraphQL.%0A%0ACheck%20it%20out%20at%3A%0A%F0%9F%94%97%20https%3A%2F%2Ftailcall.run%20%0A%F0%9F%94%97%20https%3A%2F%2Fgithub.com%2Ftailcallhq%2Ftailcall%20%0A%0A&hashtags=api,http,rest,grpc,graphql,nocode,microservice,opensource)
[![Discord](https://img.shields.io/discord/1044859667798568962?style=for-the-badge&cacheSeconds=120&logo=discord)](https://discord.gg/kRZBPpkgwq)[![Open Bounties](https://img.shields.io/endpoint?url=https%3A%2F%2Fconsole.algora.io%2Fapi%2Fshields%2Ftailcallhq%2Fbounties%3Fstatus%3Dopen&style=for-the-badge)](https://console.algora.io/org/tailcallhq/bounties?status=open)
[![Rewarded Bounties](https://img.shields.io/endpoint?url=https%3A%2F%2Fconsole.algora.io%2Fapi%2Fshields%2Ftailcallhq%2Fbounties%3Fstatus%3Dcompleted&style=for-the-badge)](https://console.algora.io/org/tailcallhq/bounties?status=completed)
[![GitHub Workflow Status (with event)](https://img.shields.io/github/actions/workflow/status/tailcallhq/tailcall/ci.yml?style=for-the-badge)](https://github.com/tailcallhq/tailcall/actions)
![GitHub release (by tag)](https://img.shields.io/github/downloads/tailcallhq/tailcall/total?style=for-the-badge)
[![Discord](https://img.shields.io/discord/1044859667798568962?style=for-the-badge&cacheSeconds=60)](https://discord.gg/kRZBPpkgwq)
[![Codecov](https://img.shields.io/codecov/c/github/tailcallhq/tailcall?style=for-the-badge)](https://app.codecov.io/gh/tailcallhq/tailcall)## Installation
### NPM
```bash
npm i -g @tailcallhq/tailcall
```### Yarn
```bash
yarn global add @tailcallhq/tailcall
```### Home Brew
```bash
brew tap tailcallhq/tailcall
brew install tailcall
```### Curl
```bash
curl -sSL https://raw.githubusercontent.com/tailcallhq/tailcall/master/install.sh | bash
```### Docker
```bash
docker pull ghcr.io/tailcallhq/tailcall/tc-server
docker run -p 8080:8080 -p 8081:8081 ghcr.io/tailcallhq/tailcall/tc-server
```## Get Started
The below file is a standard `.graphQL` file, with a few additions such as `@server` and `@http` directives. So, basically, we specify the GraphQL schema and how to resolve that GraphQL schema in the same file, without having to write any code!
```graphql
schema
@server(port: 8000, hostname: "0.0.0.0")
@upstream(baseURL: "http://jsonplaceholder.typicode.com", httpCache: 42) {
query: Query
}type Query {
posts: [Post] @http(path: "/posts")
user(id: Int!): User @http(path: "/users/{{.args.id}}")
}type User {
id: Int!
name: String!
username: String!
email: String!
phone: String
website: String
}type Post {
id: Int!
userId: Int!
title: String!
body: String!
user: User @http(path: "/users/{{.value.userId}}")
}
```Now, run the following command to start the server with the full path to the jsonplaceholder.graphql file that you created above.
```bash
tailcall start ./jsonplaceholder.graphql
```Head out to [docs] to learn about other powerful tailcall features.
[docs]: https://tailcall.run/docs
### Benchmarks
Throughput comparison of various GraphQL solutions for a N + 1 query:
```graphql
query {
posts {
title
body
user {
name
}
}
}
```![Throughput Histogram](https://raw.githubusercontent.com/tailcallhq/graphql-benchmarks/main/assets/req_sec_histogram1.png)
Check out detailed benchmarks on our benchmarking [repository](https://github.com/tailcallhq/graphql-benchmarks).
### Contributing
Your contributions are invaluable! Kindly go through our [contribution guidelines] if you are a first time contributor.
[contribution guidelines]: https://tailcall.run/docs/contribution-guidelines
### Support Us
⭐️ Give us a star.
👀 Watch us for updates.
### License
This initiative is protected under the Apache 2.0 License.