{"id":13824891,"url":"https://github.com/genuinetools/1up","last_synced_at":"2025-07-23T08:05:53.610Z","repository":{"id":57488152,"uuid":"146370280","full_name":"genuinetools/1up","owner":"genuinetools","description":"A custom Gmail spam filter bot.","archived":false,"fork":false,"pushed_at":"2020-09-17T20:03:40.000Z","size":1145,"stargazers_count":78,"open_issues_count":0,"forks_count":1,"subscribers_count":3,"default_branch":"master","last_synced_at":"2025-05-05T02:36:07.562Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Go","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/genuinetools.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2018-08-28T00:37:02.000Z","updated_at":"2022-09-10T23:29:30.000Z","dependencies_parsed_at":"2022-08-29T15:01:13.875Z","dependency_job_id":null,"html_url":"https://github.com/genuinetools/1up","commit_stats":null,"previous_names":[],"tags_count":5,"template":false,"template_full_name":null,"purl":"pkg:github/genuinetools/1up","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/genuinetools%2F1up","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/genuinetools%2F1up/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/genuinetools%2F1up/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/genuinetools%2F1up/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/genuinetools","download_url":"https://codeload.github.com/genuinetools/1up/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/genuinetools%2F1up/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":266640830,"owners_count":23960809,"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","status":"online","status_checked_at":"2025-07-23T02:00:09.312Z","response_time":66,"last_error":null,"robots_txt_status":null,"robots_txt_updated_at":null,"robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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-04T09:01:11.228Z","updated_at":"2025-07-23T08:05:53.578Z","avatar_url":"https://github.com/genuinetools.png","language":"Go","funding_links":[],"categories":["Go"],"sub_categories":[],"readme":"# 1up\n\n[![make-all](https://github.com/genuinetools/1up/workflows/make%20all/badge.svg)](https://github.com/genuinetools/1up/actions?query=workflow%3A%22make+all%22)\n[![make-image](https://github.com/genuinetools/1up/workflows/make%20image/badge.svg)](https://github.com/genuinetools/1up/actions?query=workflow%3A%22make+image%22)\n[![GoDoc](https://img.shields.io/badge/godoc-reference-5272B4.svg?style=for-the-badge)](https://godoc.org/github.com/genuinetools/1up)\n[![Github All Releases](https://img.shields.io/github/downloads/genuinetools/1up/total.svg?style=for-the-badge)](https://github.com/genuinetools/1up/releases)\n\nA custom Gmail spam filter bot.\n\n\u003c!-- START doctoc generated TOC please keep comment here to allow auto update --\u003e\n\u003c!-- DON'T EDIT THIS SECTION, INSTEAD RE-RUN doctoc TO UPDATE --\u003e\n**Table of Contents**\n\n- [How it works](#how-it-works)\n- [Installation](#installation)\n    - [Binaries](#binaries)\n    - [Via Go](#via-go)\n    - [Via Docker](#via-docker)\n- [Usage](#usage)\n\n\u003c!-- END doctoc generated TOC please keep comment here to allow auto update --\u003e\n\n## How it works\n\n\nThe bot will create 3 labels in your Gmail:\n\n- `1up/good`: where you label emails that are \"good\"\n- `1up/bad`: where you label emails that are \"bad\"\n- `1up/quarantine`: where the bot will place emails that it thinks are \"bad\"\n    based off the results of the Bayes classifier\n\nThanks to [@brendandburns](https://github.com/brendandburns) for pointing me at\nBayes classifiers.\n\n## Installation\n\n#### Binaries\n\nFor installation instructions from binaries please visit the [Releases Page](https://github.com/genuinetools/1up/releases).\n\nYou will want to follow the steps [here](https://developers.google.com/gmail/api/quickstart/go#step_1_turn_on_the) to turn on the Gmail API and get a credentials file.\n\n#### Via Go\n\n```console\n$ go get github.com/genuinetools/1up\n```\n\n#### Via Docker\n\n```console\n$ docker run --rm -it -v ~/configs/1up:/1up:ro \\\n    --tmpfs /tmp \\\n    r.j3ss.co/1up -f /1up/credentials.json\n```\n\n## Usage\n\n```console\n$ 1up -h\n1up -  A custom Gmail spam filter bot.\n\nUsage: 1up \u003ccommand\u003e\n\nFlags:\n\n  -d, --debug       enable debug logging (default: false)\n  -f, --creds-file  Gmail credential file (or env var GMAIL_CREDENTIAL_FILE) (default: \u003cnone\u003e)\n  -i, --interval    update interval (ex. 5ms, 10s, 1m, 3h) (default: 5m0s)\n  --once            run once and exit, do not run as a daemon (default: false)\n\nCommands:\n\n  version  Show the version information.\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgenuinetools%2F1up","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fgenuinetools%2F1up","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgenuinetools%2F1up/lists"}