{"id":50862175,"url":"https://github.com/cameroncodesstuff/beaver","last_synced_at":"2026-06-14T22:01:29.607Z","repository":{"id":364724351,"uuid":"1268991121","full_name":"CameronCodesStuff/beaver","owner":"CameronCodesStuff","description":"BEAVER AI","archived":false,"fork":false,"pushed_at":"2026-06-14T08:17:52.000Z","size":59,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-06-14T09:08:57.666Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Python","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/CameronCodesStuff.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"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}},"created_at":"2026-06-14T07:09:04.000Z","updated_at":"2026-06-14T07:11:13.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/CameronCodesStuff/beaver","commit_stats":null,"previous_names":["cameroncodesstuff/beaver"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/CameronCodesStuff/beaver","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CameronCodesStuff%2Fbeaver","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CameronCodesStuff%2Fbeaver/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CameronCodesStuff%2Fbeaver/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CameronCodesStuff%2Fbeaver/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/CameronCodesStuff","download_url":"https://codeload.github.com/CameronCodesStuff/beaver/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CameronCodesStuff%2Fbeaver/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34339195,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-14T02:00:07.365Z","response_time":62,"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":[],"created_at":"2026-06-14T22:01:28.808Z","updated_at":"2026-06-14T22:01:29.593Z","avatar_url":"https://github.com/CameronCodesStuff.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 🦫 BEAVER — Local Voice Assistant\n\nA fully offline, voice-controlled assistant for Windows with an over-the-top dark\nHUD. Say a wake word + command and it shows maps, videos, weather, and search\nright inside the app. Speech recognition and text-to-speech run entirely on your\nmachine — no accounts, no API keys, completely free.\n\n## Setup (Windows)\n\nYou need **Python 3.9+** ([python.org](https://www.python.org/downloads/) — tick\n*Add Python to PATH* during install).\n\n1. Unzip this folder anywhere.\n2. Double-click **`setup.bat`** (creates a virtual environment and installs\n   dependencies). Run once.\n3. Double-click **`start_beaver.bat`**.\n4. On first launch, click **INSTALL VOICE MODEL** — it downloads and installs the\n   offline model inside the app, with a progress bar. Then click **ENTER BEAVER**.\n5. Click **WAKE BEAVER**, allow microphone access, and start talking.\n\n## Say \"beaver\" + a command\n\n| Say | Result |\n|-----|--------|\n| `beaver what apps are open` | Lists running applications |\n| `beaver open windows` | Lists open window titles |\n| `beaver current tab` | Names your active browser tab |\n| `beaver recent files` | Recent files from Downloads/Documents/Desktop |\n| `beaver research electric cars` | Searches, compares sources, writes a report (saved + shown) |\n| `beaver go to github` | Navigates to a site in-app |\n| `beaver open maps of Vancouver` | Map in the viewport |\n| `beaver play lofi beats` | Plays a YouTube video in-app |\n| `beaver weather in London` | Live weather panel |\n| `beaver search for SpaceX` | Search results |\n| `beaver tell me about beavers` | Wikipedia |\n| `beaver what time is it` | Time card |\n| `beaver open calculator` | Launches calculator |\n| `beaver how do you feel` | Reports your detected mood |\n| `beaver clear` | Clears the viewport |\n\nBeaver also detects your **emotional tone** from what you say (shown as a chip in\nthe top bar) and adapts its replies — e.g. if you sound frustrated, it keeps\nthings brief and reassuring. Reports are saved as Markdown in the `reports/`\nfolder and displayed in-app.\n\n### Build websites \u0026 apps by voice\nSay things like **\"make me a simple website for a bakery\"**, \"build a calculator\napp\", or \"create a portfolio page\". Beaver generates a complete, working site and\nshows it live in the viewport. Test it right there, then just say what to change\n(\"make the background green\", \"add a contact form\") and it updates the same site,\nremembering context. Finished sites are saved in the `generated_sites/` folder.\nThis uses the Anthropic API — create a file named **`api_key.txt`** in the Beaver\nfolder with your key inside (from console.anthropic.com). Everything else works\nwithout it.\n\n### Interrupt\nWhile Beaver is speaking, just start talking — it stops and listens. There's also\na 🔇 button to silence it instantly.\n\n### Mini mode (always-on-top)\nClick 📌 to shrink Beaver into a compact panel pinned to the bottom-right corner,\nalways on top. Click again to restore.\n\nThere's also a text box if you'd rather type.\n\n### Notes on a couple of features\n- **Browser tabs:** Windows only exposes the *active* tab's title to other apps,\n  so Beaver reports the focused tab — not a full list of every open tab.\n- **Files:** Beaver scans Downloads, Documents, and Desktop by default. Change\n  `SCAN_FOLDERS` in `core/config.py` to adjust.\n- **Research/reports \u0026 site building** need internet at runtime; everything else\n  works offline.\n\n## Stack (all free / open source)\n\nPython · Vosk (offline speech-to-text) · pyttsx3 (offline TTS) · Eel · sounddevice\n\n## Troubleshooting\n\n- **requirements.txt not found** — `setup.bat` now runs from its own folder\n  automatically; just keep all the files together.\n- **Model install fails** — check your internet connection and click retry. The\n  app installs the model on first run; you don't need to download anything by hand.\n- **No mic input** — Settings → Privacy → Microphone, and confirm your input\n  device is the default.\n- **Embedded video/maps blank** — some sites block iframes; the command still\n  opens them in your real browser as a fallback.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcameroncodesstuff%2Fbeaver","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcameroncodesstuff%2Fbeaver","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcameroncodesstuff%2Fbeaver/lists"}