{"id":13523061,"url":"https://github.com/jifunks/botany","last_synced_at":"2025-10-06T20:19:14.162Z","repository":{"id":18371373,"uuid":"84123292","full_name":"jifunks/botany","owner":"jifunks","description":"command line virtual plant buddy","archived":false,"fork":false,"pushed_at":"2024-04-04T19:29:38.000Z","size":299,"stargazers_count":425,"open_issues_count":10,"forks_count":31,"subscribers_count":16,"default_branch":"master","last_synced_at":"2024-05-16T09:34:48.984Z","etag":null,"topics":["cli","curses","friends","garden","mmo","pet","plant","tilde","unix","virtual"],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"isc","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/jifunks.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,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2017-03-06T21:36:26.000Z","updated_at":"2024-06-03T18:25:04.209Z","dependencies_parsed_at":"2023-12-12T07:28:37.192Z","dependency_job_id":"d314d835-bb91-4d77-8961-75f5ec539b95","html_url":"https://github.com/jifunks/botany","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/jifunks/botany","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jifunks%2Fbotany","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jifunks%2Fbotany/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jifunks%2Fbotany/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jifunks%2Fbotany/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/jifunks","download_url":"https://codeload.github.com/jifunks/botany/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jifunks%2Fbotany/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":278672139,"owners_count":26025844,"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-10-06T02:00:05.630Z","response_time":65,"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":["cli","curses","friends","garden","mmo","pet","plant","tilde","unix","virtual"],"created_at":"2024-08-01T06:00:55.110Z","updated_at":"2025-10-06T20:19:14.117Z","avatar_url":"https://github.com/jifunks.png","language":"Python","readme":"# botany\n![Screencap](https://tilde.town/~curiouser/botany.png)\n\nby Jake Funke - jifunks@gmail.com - tilde.town/~curiouser - http://jakefunke.online/\n\nA command line, realtime, community plant buddy.\n\nYou've been given a seed that will grow into a beautiful plant.\nCheck in and water your plant every 24h to keep it growing. 5 days without water = death. Your plant depends on you and your friends to live!\n\n*\"We do not 'come into' this world; we come out of it, as leaves from a tree.\" - Alan Watts*\n\n## getting started\nbotany is designed for unix-based systems. Clone into a local directory using `$ git clone https://github.com/jifunks/botany.git`.\n\nRun with `$ python3 botany.py`.\n\n*Note - botany.py must initially be run by the user who cloned/unzipped botany.py - this initializes the shared data file permissions.*\n\nWater your seed to get started. You can come and go as you please and your plant continues to grow.\n\nMake sure to come back and water every 24 hours or your plant won't grow.\n\nIf your plant goes 5 days without water, it will die! Recruit your friends to water your plant for you!\n\nA once-weekly cron on clear_weekly_users.py should be set up to keep weekly visitors tidy.\n\n\n## features\n* Curses-based menu system, optimized for 80x24 terminal\n* 20+ Species of plants w/ ASCII art for each\n* Persistent aging system that allows your plant to grow even when app is closed\n* Multiplayer! Water your friends plants \u0026 see who's visited your garden.\n* Generations: each plant you bring to its full growth potential rewards you\n  with 20% growth speed for the next plant\n* Random and rare mutations can occur at any point in a plant's life\n* SQLite Community Garden of other users' plants (for shared unix servers)\n* Data files are created in the user's home (~) directory, along with a JSON file that can be used in other apps.\n  * Data is created for your current plant and harvested plants\n\n```\n{\n  \"description\":\"common screaming mature jade plant\",\n  \"generation\":1,\n  \"file_name\":\"/home/curiouser/.botany/curiouser_plant.dat\",\n  \"owner\":\"curiouser\",\n  \"species\":\"jade plant\",\n  \"stage\":\"mature\",\n  \"age\":\"24d:2h:16m:19s\",\n  \"rarity\":\"common\",\n  \"score\":955337.0,\n  \"mutation\":\"screaming\",\n  \"last_watered\":1529007007,\n  \"is_dead\":false\n}\n```\n\n### to-dos\n* Plant pollination - cross-breed with neighbor plants to unlock second-gen plants\n  * Share seeds with other users\n* Global events\n  * Server API to have rain storms, heat waves, insects\n* Hybridization, lineage tracking\n\n## requirements\n* Unix-based OS (Mac, Linux)\n* Python 3.x\n* Recommended: 80x24 minimum terminal, fixed-width font\n\n## credits\n* thank you [tilde.town](http://tilde.town/) for inspiration!\n\n## praise for botany\n![Screencap](https://tilde.town/~curiouser/praise1.png)\n![Screencap](https://tilde.town/~curiouser/praise2.png)\n![Screencap](https://tilde.town/~curiouser/praise3.png)\n\n## Featured in Linux Magazine!\n![IMG_7497](https://github.com/user-attachments/assets/5b778452-6cd1-489d-aeba-082f31538eb7)\n(via Graham Morrison \"FOSSPicks\" *Linux Magazine*, Issue 273, 2023)\n\n\n","funding_links":[],"categories":["Table of Contents"],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjifunks%2Fbotany","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjifunks%2Fbotany","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjifunks%2Fbotany/lists"}