{"id":13629742,"url":"https://github.com/facebook/mvfst","last_synced_at":"2025-05-13T18:05:56.643Z","repository":{"id":37978667,"uuid":"128842710","full_name":"facebook/mvfst","owner":"facebook","description":"An implementation of the QUIC transport protocol.","archived":false,"fork":false,"pushed_at":"2025-05-08T22:43:22.000Z","size":23388,"stargazers_count":1557,"open_issues_count":35,"forks_count":257,"subscribers_count":68,"default_branch":"main","last_synced_at":"2025-05-08T23:32:18.421Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"C++","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/facebook.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2018-04-09T22:49:15.000Z","updated_at":"2025-05-08T22:43:26.000Z","dependencies_parsed_at":"2023-10-14T20:48:05.637Z","dependency_job_id":"87e32d66-a41f-4969-b726-ebe50472de25","html_url":"https://github.com/facebook/mvfst","commit_stats":{"total_commits":7855,"total_committers":355,"mean_commits":22.12676056338028,"dds":0.5879057924888607,"last_synced_commit":"d93e8a0fd2cb03e4f8cfac965c4c3694e058d640"},"previous_names":["facebook/mvfst","facebookincubator/mvfst"],"tags_count":94,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/facebook%2Fmvfst","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/facebook%2Fmvfst/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/facebook%2Fmvfst/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/facebook%2Fmvfst/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/facebook","download_url":"https://codeload.github.com/facebook/mvfst/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254000845,"owners_count":21997441,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-08-01T22:01:18.116Z","updated_at":"2025-05-13T18:05:56.635Z","avatar_url":"https://github.com/facebook.png","language":"C++","funding_links":[],"categories":["C++"],"sub_categories":[],"readme":"![alt text](logo.png \"MVFST\")\n\n[![Linux Build Status](https://github.com/facebook/mvfst/actions/workflows/getdeps_linux.yml/badge.svg)](https://github.com/facebook/mvfst/actions/workflows/getdeps_linux.yml)\n[![macOS Build Status](https://github.com/facebook/mvfst/actions/workflows/getdeps_mac.yml/badge.svg)](https://github.com/facebook/mvfst/actions/workflows/getdeps_mac.yml)\n[![Windows Build Status](https://github.com/facebook/mvfst/actions/workflows/getdeps_windows.yml/badge.svg)](https://github.com/facebook/mvfst/actions/workflows/getdeps_windows.yml)\n\n## Introduction\n`mvfst` (Pronounced *move fast*) is a client and server implementation of [IETF QUIC](https://quicwg.org/) protocol in C++ by Facebook. QUIC is a UDP based reliable, multiplexed transport protocol that will become an internet standard. The goal of `mvfst` is to build a performant implementation of the QUIC transport protocol that applications could adapt for use cases on both the internet and the data-center. `mvfst` has been tested at scale on android, iOS apps, as well as servers and has several features to support large scale deployments.\n\n## Features\n**Server features**:\n- Multi-threaded UDP socket server with a thread local architecture to be able to scale to multi-core servers\n- Customizable Connection-Id routing. The default Connection-Id routing implementation integrates seamlessly with [katran](https://github.com/facebookincubator/katran)\n- APIs to enable zero-downtime restarts of servers, so that applications do not have to drop connections when restarting.\n- APIs to expose transport and server statistics for debuggability\n- Zero-Rtt connection establishment and customizable zero rtt path validation\n- Support for UDP Generic segmentation offloading (GSO) for faster UDP writes.\n\n**Client features**:\n- Native happy eyeballs support between ipv4 and ipv6 so that applications do not need to implement it themselves\n- Pluggable congestion control and support for turning off congestion control to plug in application specific control algorithms\n\n## Source Layout\n- `quic/api`:         Defines API that applications can use to interact with the QUIC transport layer.\n- `quic/client`:      Client transport implementation\n- `quic/codec`:       Read and write codec implementation for the protocol\n- `quic/common`:      Implementation of common utility functions\n- `quic/congestion_control`: Implementation of different congestion control algorithms such as Cubic and Copa\n- `quic/flowcontrol`: Implementations of flow control functions\n- `quic/handshake`:   Implementations cryptographic handshake layer\n- `quic/happyeyeballs`: Implementation of mechanism to race IPV4 and IPV6 connection and pick a winner\n- `quic/logging`:     Implementation of logging framework\n- `quic/loss`:        Implementations of different loss recovery algorithms\n- `quic/samples`:     Example client and server\n- `quic/server`:      Server transport implementation\n- `quic/state`:       Defines and implements both connection and stream level state artifacts and state machines\n\n\n## Dependencies\n\n`mvfst` largely depends on two libraries: [folly](https://www.github.com/facebook/folly) and [fizz](https://www.github.com/facebookincubator/fizz).\n\n## Building mvfst\n\n### Method 1 \\[Recommended]: Using Getdeps.py\n\nThis script is used by many of Meta's OSS tools.  It will download and build all of the necessary dependencies first, and will then invoke cmake, etc. to build mvfst.  This will help ensure that you build with relevant versions of all of the dependent libraries, taking into account what versions are installed locally on your system.\n\nIt's written in python so you'll need python3.6 or later on your PATH.  It works on Linux, macOS and Windows.\n\nThe settings for mvfst's cmake build are held in its getdeps manifest `build/fbcode_builder/manifests/mvfst`, which you can edit locally if desired.\n\n#### Dependencies\n\nIf on Linux or MacOS (with homebrew installed) you can install system dependencies to save building them:\n\n    # Clone the repo\n    git clone https://github.com/facebook/mvfst.git\n    # Install dependencies\n    cd mvfst\n    sudo ./build/fbcode_builder/getdeps.py install-system-deps --recursive --install-prefix=$(pwd)/_build mvfst\n\n\nIf you'd like to see the packages before installing them:\n\n    ./build/fbcode_builder/getdeps.py install-system-deps --dry-run --recursive mvfst\n\nOn other platforms or if on Linux and without system dependencies `getdeps.py` will mostly download and build them for you during the build step.\n\n#### Build\n\nFor a simplified build, you can use the `getdeps.sh` wrapper script. This will download and build all the required dependencies, then build mvfst. It will use the default scratch path for building and install the result in _build.\n\n    # Clone the repo\n    git clone https://github.com/facebook/mvfst.git\n    # Build using the wrapper script\n    cd mvfst\n    ./getdeps.sh\n\nAt the end of the build, mvfst binaries will be installed at `_build/mvfst`. You can find the scratch path from the logs or by running `python3 ./build/fbcode_builder/getdeps.py show-build-dir mvfst`.\n\nFor more control over `getdeps.py`, you can run the tool directly.\n\n    # Show help\n    python3 ./build/fbcode_builder/getdeps.py build mvfst -h\n    # Build mvfst, using system packages for dependencies if available\n    python3 ./build/fbcode_builder/getdeps.py --allow-system-packages build mvfst --install-prefix=$(pwd)/_build\n\n#### Run tests\n\nBy default `getdeps.py` will build the tests for mvfst. You can use it to run them too:\n\n    python3 ./build/fbcode_builder/getdeps.py test mvfst --install-prefix=$(pwd)/_build\n\n### Method 2 \\[Deprecated]: Using build.sh script\n\nThis method can be used on Ubuntu 18+ and macOS.\n\nTo begin, you should install the dependencies we need for build. This largely\nconsists of dependencies from [folly](https://github.com/facebook/folly) as well as\n[fizz](https://github.com/facebookincubator/fizz).\n\n```\nsudo apt-get install         \\\n    g++                      \\\n    cmake                    \\\n    libboost-all-dev         \\\n    libevent-dev             \\\n    libdouble-conversion-dev \\\n    libgoogle-glog-dev       \\\n    libgflags-dev            \\\n    libiberty-dev            \\\n    liblz4-dev               \\\n    liblzma-dev              \\\n    libsnappy-dev            \\\n    make                     \\\n    zlib1g-dev               \\\n    binutils-dev             \\\n    libjemalloc-dev          \\\n    libssl-dev               \\\n    pkg-config               \\\n    libsodium-dev\n```\n\nThen, build and install folly and fizz\n\nAlternatively, run the helper script `build_helper.sh` in this subdirectory.\nIt will install and link the required dependencies and also build folly and fizz.\nThis may take several minutes the first time.\n\n```\n./build_helper.sh\n```\n\nAfter building, the directory `_build/` will contain the dependencies\n(under `_build/deps`) whereas `_build/build` will contain all the\nbuilt libraries and binaries for `mvfst`.\n\nYou can also install `mvfst` as well as its dependencies `folly` and `fizz`\nto a custom directory using the build script, by supplying an `INSTALL_PREFIX`\nenv var.\n```\n./build_helper.sh -i /usr/local\n```\nSee `./build_helper.sh --help` for more options\n\nYou might need to run the script as root to install to certain directories.\n\nBy default the build script `build_helper.sh` enables the building of test target (i.e. runs with `-DBUILD_TEST=ON` option). Since some of tests in `mvfst` require some test artifacts of Fizz, it is necessary to supply the path of the Fizz src directory (via option `DFIZZ_PROJECT`) to correctly build all test targets in `mvfst`.\n\n## Run a sample client and server\nBuilding the test targets of `mvfst` should automatically build the sample client and server binaries into the build directory.\n\nFor `getdeps.py` build, you can find the echo binary at:\n```\ncd $(python3 ./build/fbcode_builder/getdeps.py show-build-dir mvfst)/quic/samples/echo\n```\n\nFor the deprecated `build.sh` script, it will be at the following location if you used the default build path.\n```\ncd ./_build/build/quic/samples/echo\n```\n\nThe server will automatically bind to `::1` by default if no host is used, but you can then spin a simple echo server by running:\n```\n./echo -mode=server -host=\u003chost\u003e -port=\u003cport\u003e\n```\nand to run a client:\n```\n./echo -mode=client -host=\u003chost\u003e -port=\u003cport\u003e\n```\nFor more options, see\n```\n./echo --help\n```\n## HTTP/3\nThis repo implements the QUIC transport. For an HTTP/3 implementation that uses Mvfst, please check out [Proxygen](https://github.com/facebook/proxygen).\n\n## Contributing\n\nWe'd love to have your help in making `mvfst` better. If you're interested, please\nread our guide to [guide to contributing](CONTRIBUTING.md)\n\nPlease also join our\n[slack](https://mvfst.slack.com) to ask questions or start discussions.\n\n## License\n`mvfst` is MIT licensed, as found in the LICENSE file.\n\n## API\nThe API should be considered in alpha. We can't predict all the use cases that\npeople will have, so we're waiting some time before declaring a more stable API.\nWe are open to have several different APIs for different constraints.\n\n## Reporting and Fixing Security Issues\n\nPlease do not open GitHub issues or pull requests - this makes the problem\nimmediately visible to everyone, including malicious actors. Security issues in\n`mvfst` can be safely reported via Facebook's Whitehat Bug Bounty program:\n\nhttps://www.facebook.com/whitehat\n\nFacebook's security team will triage your report and determine whether or not is\nit eligible for a bounty under our program.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffacebook%2Fmvfst","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ffacebook%2Fmvfst","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffacebook%2Fmvfst/lists"}