# arsduo/koala

A lightweight Facebook library supporting the Graph, Marketing, and Atlas APIs, realtime updates, test users, and OAuth.

Repository: https://github.com/arsduo/koala
Canonical: https://ross.abutalabs.com/products/arsduo-koala
Homepage: http://developers.facebook.com/
Language: Ruby
License: MIT
License Family: permissive
Topics: facebook, ruby, ruby-on-rails, social-network
Last push: 2025-10-16T20:10:00+00:00

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

## Adoption (not part of the score)
Stars 3568, forks 456 (observed 2026-08-28T04:08:10.024150+00:00)

## What it is
Koala is a lightweight Ruby library for the Facebook Graph, Marketing, and Atlas APIs, including realtime updates, test users, batch requests, and OAuth validation. It aims to be fast, flexible, and fully tested, integrating easily with Ruby and Rails applications.

## Use cases
- access the facebook graph api from ruby
- implement facebook login oauth in a rails app
- post photos and batch requests to facebook
- manage facebook ads via the marketing api
- subscribe to facebook realtime updates
- create facebook test users for testing
- validate facebook access tokens

## When to choose
- you're building a Ruby or Rails app that talks to Facebook's Graph or Marketing APIs
- you want a lightweight, unopinionated wrapper that returns plain JSON
- you need OAuth validation and realtime updates support in Ruby

## When to avoid
- your project is not in Ruby
- you need official SDK support or the newest Facebook API features on day one
- you need threadsafe global configuration

## Facets
- artifact type: library
- maturity: maintenance
- function: http-client, auth, sdk
- domain: apis, social-media, web-development, developer-tools
- platform: ruby, cross-platform
- tags: facebook-graph-api, facebook-marketing-api, oauth, social-network, rails

## Member repositories
- arsduo/koala (main) score 53

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:08:10.024150+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-29T18:34:09.323281+00:00, confidence not recorded.
  - readme: https://github.com/arsduo/koala (fetched 2026-08-28T04:08:10.024150+00:00, sha 581ff0f224c6)
  - homepage: http://developers.facebook.com/ (fetched 2026-08-29T09:27:50.249919+00:00, sha b9c26387a2a9)
  - site_page: https://developers.facebook.com/docs (fetched 2026-08-29T09:27:50.259553+00:00, sha 9f43959ff8ae)
  - site_page: https://developers.facebook.com/social-technologies/social-integrations (fetched 2026-08-29T09:27:50.261551+00:00, sha 590e249b176a)
  - site_page: https://developers.facebook.com/blog/post/2026/07/29/introducing-graph-api-v26-and-marketing-api-v26 (fetched 2026-08-29T09:27:50.263567+00:00, sha 2239d3cb0155)
- Data as of 2026-08-30T08:39:29.467469+00:00.