# Code from Portuguese organisations on GitHub

Public repositories and latest releases of Portuguese startups, companies, public bodies, universities and open-source projects on GitHub, each with its source URL, licence and the time read.

## At a glance

| Field | Value |
|---|---|
| Publisher | The organisations listed in sources/github-pt/orgs.json, through GitHub, Inc.'s REST API |
| Source | [https://api.github.com/](https://api.github.com/) |
| Reader page | [https://github.com/](https://github.com/) |
| Schedule | every 6 hours: the Pages workflow (.github/workflows/pages.yml) at 17 minutes past 00, 06, 12 and 18 UTC; every other hourly run keeps the last read, copied from the live site. The workflow passes no token to the collectors, so a run uses the anonymous quota (60 requests an hour): every organisation's repositories, then releases until 10 requests remain, with a gap for the rest. A token would read every release; whether to give one is Dinis's decision. |
| Owner | data.b.dev@PrompTugal.dinis |
| Collector | [sources/github-pt/collect.mjs](https://github.com/PrompTugal/PrompTugal__News__Data/blob/dev/sources/github-pt/collect.mjs) |
| Since | 2026-11-18 |
| Last read | 2026-11-18 19:14 UTC |
| Last run | ok: 31 requests ok, 0 failed |
| Now | 21 orgs |
| Licence | The data: [the source's terms](https://docs.github.com/en/site-policy/github-terms/github-terms-of-service#h-api-terms) (each repository's organisation). This page, the card and the records we add: [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/). |

## Reuse terms

GitHub's terms allow this use: reading public data through the API is permitted; excessive requests may be suspended; data must not be used for spam or to sell users' personal information. We read organisations' public repositories and releases only, collect no personal data, stay well under the rate limits, and keep each repository's own licence (or a link to its terms) on every item. Not reviewed by a person. Reuse: with conditions: each item keeps its repository's own licence, or links to the repository's terms where it declares none; no personal data; no use for spam; keep to the rate limits.

> "You may not use the API to download data or Content from GitHub for spamming purposes, including for the purposes of selling GitHub users' personal information, such as to recruiters, headhunters, and job boards." Also: "Abuse or excessively frequent requests to GitHub via the API may result in the temporary or permanent suspension of your Account's access to the API." And in the Acceptable Use Policies, section 7, Information Usage Restrictions (https://docs.github.com/en/site-policy/acceptable-use-policies/github-acceptable-use-policies, read 2026-11-18): "Scraping does not refer to the collection of information through our API." (Quotes as returned by a page reader, which cut some sentences short.)
>
> The publisher's words (en), from [https://docs.github.com/en/site-policy/github-terms/github-terms-of-service#h-api-terms](https://docs.github.com/en/site-policy/github-terms/github-terms-of-service#h-api-terms), read on 2026-11-18.

**Open question:** Repository descriptions and release names are the organisations' own text: shown as short plain-text excerpts with a link. Dinis to decide whether to republish them beyond that. GitHub's Privacy Statement governs any personal information; none is collected.

## What runs by code, by agents and by people

### Code

- the collector reads the organisations' public repositories and releases and writes latest.json and reads.json
- GitHub Actions runs it every 6 hours and deploys the site
- the build makes the API, the OpenAPI description and the pages

### Agents

- data.b.dev@PrompTugal.dinis (Sonnet) wrote the collector, the organisations list, this card and the threat model on 18 November 2026, for data.b@PrompTugal.dinis

### People

- Dinis Cruz decided the code collection on 18 November 2026 (about 15:40 UTC); no person has checked the organisations list or the values yet (not reviewed)

## Cost

| Field | Value |
|---|---|
| per run tokens | 0 |
| per run model cost usd | 0 |
| runner | GitHub Actions on a public repository: no charge; one request per organisation plus up to 150 for releases, at one a second (planned; measured figure to be added) |
| build tokens | not measured |
| note | Code only: no model is called when the data is collected. |

## API addresses

These addresses stay for the life of v1 ([the contract](/api/v1/README.md)).

| File | Address |
|---|---|
| Latest read | [https://data.promptugal.news/api/v1/github-pt/latest.json](https://data.promptugal.news/api/v1/github-pt/latest.json) |
| Every read | [https://data.promptugal.news/api/v1/github-pt/reads.json](https://data.promptugal.news/api/v1/github-pt/reads.json) |
| Card | [https://data.promptugal.news/api/v1/github-pt/card.json](https://data.promptugal.news/api/v1/github-pt/card.json) |
| OpenAPI | [https://data.promptugal.news/api/v1/github-pt/openapi.json](https://data.promptugal.news/api/v1/github-pt/openapi.json) |

```
curl -s https://data.promptugal.news/api/v1/github-pt/latest.json
curl -s https://data.promptugal.news/api/v1/github-pt/reads.json | head -c 600
```

## Vault

Vault not yet created. The collector writes the bytes of each read to a vault copy; until the vault exists they are not kept.

## Last runs

| Time (UTC) | Requests ok | Requests failed | Reads with changed bytes |
|---|---|---|---|
| 2026-11-18 19:14 UTC | 31 | 0 | 31 of 31 |

Showing 1 of 1 runs kept. Full detail with sha256: [reads.json](https://data.promptugal.news/api/v1/github-pt/reads.json).

## Preview of the values

The first 5 of 21 entries in `orgs`, as read 2026-11-18 19:14 UTC. Source: [https://api.github.com](https://api.github.com). Long values are shortened here; the file has them whole.

| login | name | kind | url | verified_how | verified_at | Source |
|---|---|---|---|---|---|---|
| codacy | Codacy | startup | https://github.com/codacy | Profile location 'Portugal'; blog https://www.codacy.com, whose footer shows ... | 2026-11-18 | [source](https://api.github.com/orgs/codacy/repos) |
| subvisual | Subvisual | company | https://github.com/subvisual | Profile location 'Portugal'; blog https://subvisual.com/, whose page links gi... | 2026-11-18 | [source](https://api.github.com/orgs/subvisual/repos) |
| ubiwhere | Ubiwhere | company | https://github.com/ubiwhere | Profile location 'Aveiro, Portugal'; blog https://www.ubiwhere.com, whose foo... | 2026-11-18 | [source](https://api.github.com/orgs/ubiwhere/repos) |
| mindera | Mindera | company | https://github.com/mindera | Profile location starts 'Porto, Portugal' (also Leicester, UK and San Diego, ... | 2026-11-18 | [source](https://api.github.com/orgs/mindera/repos) |
| farfetch | Farfetch | company | https://github.com/farfetch | Profile location 'Portugal'; blog https://farfetchtechblog.com. | 2026-11-18 | [source](https://api.github.com/orgs/farfetch/repos) |

---

Version v0.1.47 · data read 2026-11-18 19:18 UTC · Code Apache-2.0; our pages, records and visualisations CC BY 4.0; each source's data under its own licence or terms, linked · [Repository](https://github.com/PrompTugal/PrompTugal__News__Data) · [Pay for what you read](https://promptugal.news/account/) · https://data.promptugal.news/sources/github-pt/
