# twitter/finatra

Fast, testable, Scala services built on TwitterServer and Finagle

Repository: https://github.com/twitter/finatra
Canonical: https://ross.abutalabs.com/products/finatra
Homepage: https://twitter.github.io/finatra/
Language: Scala
License: Apache-2.0
License Family: permissive
Topics: scala, finagle, twitter-server, http, framework, microservices, thrift, guice, slf4j, testing
Last push: 2025-08-18T21:11:27+00:00

## Health v2 (maintenance only)
Score: 39/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 37, release rhythm 8, longevity 100
- inputs: {"age_days": 5312, "days_push": 380, "days_rel": null, "gap_med": null, "n_releases_24m": 0}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 2272, forks 403 (observed 2026-08-28T04:06:33.201571+00:00)

## What it is
Finatra is a lightweight Scala framework for building fast, testable HTTP and Thrift services on top of TwitterServer and Finagle. It provides controllers, filters, Jackson-based JSON support, optional Guice dependency injection, SLF4J logging integration, and extensive feature and integration testing utilities.

## Use cases
- build http rest apis in scala
- create thrift rpc services in scala
- build microservices on top of finagle
- write integration tests for scala http servers
- add dependency injection with guice to scala services
- handle json parsing with required fields and validation in scala apis
- build production-grade scala server applications

## When to choose
- you are building Scala HTTP or Thrift services and want Finagle's performance with a higher-level API
- you need first-class feature and integration testing support with embedded servers
- you are already in the Twitter/Finagle ecosystem and want TwitterServer operational features out of the box
- you want per-route or per-controller composable filter middleware

## When to avoid
- your project is not on the JVM or not written in Scala
- you need a simple service or script where the Finagle/TwitterServer stack is overkill
- your team prefers mainstream Scala stacks like Play, Akka HTTP/Pekko, or Spring Boot with larger communities
- you want an annotation-driven, container-style framework rather than Finatra's idiomatic controller/filter style

## Facets
- artifact type: framework
- maturity: stable
- function: web-framework, api-framework, http-server, rpc, routing, middleware, serialization, testing
- domain: web-development, backend, apis, microservices, testing
- platform: jvm
- tags: scala, finagle, twitter-server, thrift, guice, dependency-injection, jackson-json, slf4j-logging, embedded-test-servers, microservices

## Member repositories
- twitter/finatra (main) score 39

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:06:33.201571+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T02:41:47.420236+00:00, confidence not recorded.
  - readme: https://github.com/twitter/finatra (fetched 2026-08-28T04:06:33.201571+00:00, sha d24d6108b6c1)
  - homepage: https://twitter.github.io/finatra/ (fetched 2026-08-29T10:22:09.486652+00:00, sha 5eedbcbf7bbb)
- Data as of 2026-08-30T08:39:29.467469+00:00.