{"id":20120802,"url":"https://github.com/nthnn/tomo","last_synced_at":"2026-03-06T14:11:43.912Z","repository":{"id":229179631,"uuid":"773125945","full_name":"nthnn/tomo","owner":"nthnn","description":"An AI-like handheld interactable full of emotion companion pet made with ESP32 NodeMCU via Arduino Platform.","archived":false,"fork":false,"pushed_at":"2024-03-22T14:01:28.000Z","size":559,"stargazers_count":7,"open_issues_count":0,"forks_count":1,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-11-08T23:03:56.471Z","etag":null,"topics":["arduino-robot","companion","companion-app","companionship","esp32","esp32-arduino","mini-robot","robot"],"latest_commit_sha":null,"homepage":"","language":"C++","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/nthnn.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE/CERN OHL Permissive v2.txt","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,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null},"funding":{"github":"nthnn","custom":"https://www.buymeacoffee.com/nthnn"}},"created_at":"2024-03-16T20:23:00.000Z","updated_at":"2025-10-02T10:23:05.000Z","dependencies_parsed_at":null,"dependency_job_id":"312d0a9b-c1f1-44b8-9f8f-fbd1f8af6e34","html_url":"https://github.com/nthnn/tomo","commit_stats":null,"previous_names":["nthnn/tomo"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/nthnn/tomo","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nthnn%2Ftomo","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nthnn%2Ftomo/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nthnn%2Ftomo/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nthnn%2Ftomo/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/nthnn","download_url":"https://codeload.github.com/nthnn/tomo/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nthnn%2Ftomo/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":30180644,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-03-06T12:39:21.703Z","status":"ssl_error","status_checked_at":"2026-03-06T12:36:09.819Z","response_time":250,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"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":["arduino-robot","companion","companion-app","companionship","esp32","esp32-arduino","mini-robot","robot"],"created_at":"2024-11-13T19:23:13.124Z","updated_at":"2026-03-06T14:11:43.904Z","avatar_url":"https://github.com/nthnn.png","language":"C++","funding_links":["https://github.com/sponsors/nthnn","https://www.buymeacoffee.com/nthnn"],"categories":[],"sub_categories":[],"readme":"\u003cp align=\"center\"\u003e\n    \u003cimg src=\"assets/tomo-logo.png\" width=\"350\" /\u003e\u003c/p\u003e\n    \u003ch1 align=\"center\"\u003eTomo\u003c/h1\u003e\n    \u003cp align=\"center\"\u003eYour Emotional Pet Companion\u003c/p\u003e\n\u003c/p\u003e\n\n![PlatformIO CI](https://github.com/nthnn/tomo/actions/workflows/platformio-ci.yml/badge.svg)\n[![License](https://img.shields.io/badge/license-GPL-blue.svg)](https://github.com/nthnn/tomo/blob/main/LICENSE)\n[![License](https://img.shields.io/badge/license-CERN%20Permissive%20v2-blue.svg)](https://github.com/nthnn/tomo/blob/main/LICENSE)\n\u003ca href=\"https://www.buymeacoffee.com/nthnn\"\u003e\u003cimg src=\"https://www.buymeacoffee.com/assets/img/custom_images/orange_img.png\" height=\"20px\"\u003e\u003c/a\u003e\n\n\u003cimg src=\"assets/tomo-board.png\" align=\"right\" width=\"250\" /\u003e\n\n\u003e An AI-like handheld interactable full of emotion companion pet made with ESP32 NodeMCU via Arduino Platform.\n\nTomo is an interactive handheld companion pet crafted using ESP32 NodeMCU and developed on the Arduino platform. This project aims to create a small, emotionally expressive device with a 0.96-inch monochromatic OLED display serving as its facial interface, and a momentary button for user interaction. The name \"Tomo\" is inspired by the Japanese character \"友,\" which translates to \"friend\" or \"companion,\" reflecting the nature of this delightful creation.\n\nTomo embodies the essence of companionship in a compact and accessible form factor, offering users a unique blend of technology and emotional connection. Its minimalist design and intuitive interaction model make it suitable for various applications, from personal entertainment to educational tools.\n\n\u003e [!NOTE]\n\u003e Tomo is a project developed for educational and recreational purposes. It is not a substitute for professional mental health support or therapy.\n\n## Why Tomo?\n\n- **Emotive Expressions**: Tomo boasts a range of facial animations displayed on its 0.96-inch OLED screen, allowing it to convey emotions and engage users in interactive experiences.\n\n- **Interaction**: Users can interact with Tomo through a simple momentary button interface, enabling them to engage with its various expressions and behaviors.\n\n## Getting Started\n\nTo get started with Tomo, follow these steps:\n\n1. Download Tomo from this [link](https://github.com/nthnn/tomo) or clone the repository with the following command:\n\n```bash\ngit clone https://github.com/nthnn/tomo --depth 1\n```\n\n2. Acquire a compatible board either from my website's [shop](https://nthnn.github.io/shop.html) or alternatively, you can fabricate your own board using the provided PCB gerber files and schematics located in the [pcb](pcb) directory.\n3. Open the downloaded project repository using [PlatformIO](https://platformio.org/) extension on VS Code.\n4. Connect your ESP32 NodeMCU board with the Tomo PCB shield securely plugged in.\n5. Upload the Tomo firmware via PlatformIO.\n6. Your Tomo is now ready!\n\n## PCB Shield-style Design\n\n| Board Front Design                    | Board Back Design                   |\n|---------------------------------------|-------------------------------------|\n| ![Front](assets/tomo-board-front.svg) | ![Back](assets/tomo-board-back.svg) |\n\n## Schematic Diagram\n\nYou can get the printable PDF version of schematic diagram [here](pcb/tomo-schematic-diagram.pdf).\n\n\u003cp align=\"center\"\u003e\n    \u003cimg alt=\"Tomo Schematic Diagram\" src=\"pcb/tomo-schematic-diagram.png\" /\u003e\n\u003c/p\u003e\n\n## License\n\nYour use of Tomo is subject to the terms and conditions of the following respective licenses. Make sure to comply with the licensing requirements when using or distributing Tomo.\n\n* The firmware, including the header files and source files of Tomo, are all under the [GNU GPL v3.0 license](LICENSE/GNU%20GPL%20v3.0.txt).\n* Asset files such as Tomo board preview images, logo, PCB preview, and Piskel facial animations are under the Creative Commons (CC BY-NC-SA 4.0).\n\n    [Tomo](https://github.com/nthnn/tomo) © 2024 by [Nathanne Isip](https://github.com/nthnn) is licensed under [CC BY-NC-SA 4.0](http://creativecommons.org/licenses/by-nc-sa/4.0/?ref=chooser-v1)\n\n* The schematic diagram (both in PDF and PNG format) and the PCB gerber file shall be under [CERN OHL Permissive v2 license](LICENSE/CERN%20OHL%20Permissive%20v2.txt).\n\n---\n\n\u003cp align=\"center\"\u003e\u003ca href=\"https://github.com/nthnn/tomo\"\u003eTomo\u003c/a\u003e \u0026copy; 2024 by \u003ca href=\"https://github.com/nthnn\"\u003eNathanne Isip\u003c/a\u003e\u003c/p\u003e","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnthnn%2Ftomo","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fnthnn%2Ftomo","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnthnn%2Ftomo/lists"}