{"id":15395154,"url":"https://github.com/orhun/godsays","last_synced_at":"2025-08-20T20:32:29.231Z","repository":{"id":53453176,"uuid":"379402170","full_name":"orhun/godsays","owner":"orhun","description":"Rust port of the Terry Davis' (RIP) \"god says\" program","archived":false,"fork":false,"pushed_at":"2024-05-29T20:51:14.000Z","size":89,"stargazers_count":131,"open_issues_count":0,"forks_count":9,"subscribers_count":4,"default_branch":"master","last_synced_at":"2025-08-09T23:56:15.630Z","etag":null,"topics":["hacktoberfest","rust","templeos","terry-davis"],"latest_commit_sha":null,"homepage":"https://godsays.xyz","language":"Rust","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/orhun.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null},"funding":{"github":"orhun","patreon":"orhunp"}},"created_at":"2021-06-22T21:13:24.000Z","updated_at":"2025-07-29T19:31:43.000Z","dependencies_parsed_at":"2023-01-31T23:45:50.238Z","dependency_job_id":null,"html_url":"https://github.com/orhun/godsays","commit_stats":null,"previous_names":[],"tags_count":5,"template":false,"template_full_name":null,"purl":"pkg:github/orhun/godsays","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/orhun%2Fgodsays","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/orhun%2Fgodsays/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/orhun%2Fgodsays/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/orhun%2Fgodsays/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/orhun","download_url":"https://codeload.github.com/orhun/godsays/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/orhun%2Fgodsays/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":271378680,"owners_count":24749192,"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-08-20T02:00:09.606Z","response_time":69,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","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":["hacktoberfest","rust","templeos","terry-davis"],"created_at":"2024-10-01T15:26:13.615Z","updated_at":"2025-08-20T20:32:28.958Z","avatar_url":"https://github.com/orhun.png","language":"Rust","funding_links":["https://github.com/sponsors/orhun","https://patreon.com/orhunp"],"categories":[],"sub_categories":[],"readme":"![terry](https://user-images.githubusercontent.com/24392180/122981344-50e0bb00-d3a2-11eb-9132-2c0b4733457f.jpg)\n\n_RIP [Terry A. Davis](https://en.wikipedia.org/wiki/Terry_A._Davis) 1969-2018_\n\n# god says\n\nRust port of the programmer Terry Davis' `\"god says\"` (AKA `GodSpeaks`) program.\n\n---\n\nTerrence Andrew Davis (December 15, 1969 – August 11, 2018) was an American programmer who created and designed the operating system [`TempleOS`](https://en.wikipedia.org/wiki/TempleOS) alone. It was a highly complex and unusual undertaking for one person, as the project extended to building core components such as programming language, editor, compiler and kernel virtually from scratch. Davis also posted video blogs to social media, and by the time of his death, had amassed a small online following. He often referred to himself as \"the smartest programmer that's ever lived\". _From_ [Wikipedia](https://en.wikipedia.org/wiki/Terry_A._Davis).\n\nAbout TempleOS, from his own words:\n\n\u003e TempleOS is God's official temple.  Just like Solomon's temple, this is a\ncommunity focal point where offerings are made and God's oracle is consulted.\n\nContained in Terry's TempleOS masterpiece were various random text generators. Terry believed that by generating this text one could \"speak to God\". Through making random associations in the text, much like a [Rorschach ink-blot test](https://en.wikipedia.org/wiki/Rorschach_test).\n\nFor that purpose, he designed a random number generator called `god`, and used it in TempleOS to generate text.\n\nThe original source of this program can be found [here](https://github.com/cia-foundation/TempleOS/tree/archive/Adam/God).\n\nBesides the original program which was written in `HolyC`, he was using a bash script to generate text:\n\n```sh\n#!/bin/bash\n# This prints random words.\necho \"$(gshuf -n 32 ./Happy.TXT --random-source=/dev/urandom | tr '\\n' ' ')\"\n```\n\nSo I reproduced this logic in Rust and created a simple CLI program ([godsays](#cli)) and a webserver ([godsays-server](#server)) for extended use-cases (and tribute to TAD).\n\n\u003e Please note that some of the words may be offensive - I am merely using Terry's original wordlist and thus cannot be held responsible for any of the views expounded by God in the generated text. The only modification that has been made to Terry's text is the replacement of underscores with spaces.\n\n- [god says](#god-says)\n  - [Installation](#installation)\n  - [Usage](#usage)\n    - [CLI](#cli)\n      - [Docker](#docker)\n    - [Server](#server)\n      - [Docker](#docker-1)\n  - [See also](#see-also)\n  - [License](#license)\n  - [Copyright](#copyright)\n\n## Installation\n\nInstall the CLI tool from [crates.io](https://crates.io/crates/godsays):\n\n```sh\ncargo install godsays\n```\n\n## Usage\n\n### CLI\n\n`godsays` command line tool simply selects 32 random words from [Happy.TXT](./Happy.TXT) and prints them out.\n\n```sh\ncargo run\n```\n\noutput:\n\n```\nsloth special case I'll ask nicely incredibly in a galaxy far far away what do you want I'm done slumin oh no the enquirer really by the way that's for me to know Isn't that special don't mention it baffling furious I'll think about it Han shot first downer unsung hero super computer horrendous ahh who's to say You da man I give up cosmetics it'd take a miracle stuff holy grail I'll be back\n```\n\n\\* Use of the `--release` flag embeds the [Happy.TXT](./Happy.TXT) into the binary.\n\n#### Docker\n\nPull the latest image from Docker Hub and run the container:\n\n```sh\ndocker pull orhunp/godsays\ndocker run -t orhunp/godsays\n```\n\nOr do it manually:\n\n```sh\ndocker build -f docker/cli/Dockerfile -t godsays .\ndocker run -t godsays\n```\n\n### Server\n\n`godsays-server` is a simple HTTP server with the same purpose of `godsays`. It returns the randomly generated text on a `GET /` request. (Use `GET /json` for JSON output)\n\n```sh\ncurl https://godsays.xyz\n```\n\noutput:\n\n```\nba ha you know a better God do not disturb its trivial obviously ho ho ho failure to communicate if anything can go wrong do you like it in a perfect world that's all folks eh Mission Accomplished super computer Trump kick back vice liberal gosh baffling I'm in suspense holier than thou frown in a galaxy far far away in practice China tree hugger scum snap out of it I'm on a roll joyful money what's it to you\n```\n\nto run locally:\n\n```sh\ncargo run --features server --bin godsays-server\n```\n\n\\* A fun use case is creating a git alias as follows:\n\n```sh\ngit config --global alias.godsays '!git commit -m \"$(curl -s https://godsays.xyz)\"'\n```\n\n#### Docker\n\nPull the latest image from Docker Hub and run the container:\n\n```sh\ndocker pull orhunp/godsays-server\ndocker run --rm -e \"ADDR=0.0.0.0:3000\" -dp 3000:3000 orhunp/godsays-server\n```\n\nOr do it manually:\n\n```sh\ndocker build -f docker/server/Dockerfile -t godsays-server .\ndocker run --rm -e \"ADDR=0.0.0.0:3000\" -dp 3000:3000 godsays-server\n```\n\n## See also\n\n* https://templeos.org/\n* [TempleOS Archive](https://archive.org/details/TerryADavis_TempleOS_Archive)\n* https://www.youtube.com/watch?v=xDHQ1yBbS-Q (Tribute Terry Davis)\n* https://www.youtube.com/watch?v=mBgIBF9Y6PE (TempleOS: Terry Responds to the Haters)\n* https://jcpsimmons.github.io/Godspeak-Generator/ (JavaScript port)\n* https://github.com/rethyxyz/godspeaks (Python port)\n* https://christine.website/blog/templeos-2-god-the-rng-2019-05-30 (`god`, the Random Number Generator)\n\n## License\n\n[The MIT License](https://opensource.org/licenses/MIT)\n\n## Copyright\n\nCopyright © 2021-2024, [Orhun Parmaksız](mailto:orhunparmaksiz@gmail.com)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Forhun%2Fgodsays","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Forhun%2Fgodsays","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Forhun%2Fgodsays/lists"}