{"id":13758712,"url":"https://github.com/OpenVoiceOS/ovos-personal-backend","last_synced_at":"2025-05-10T08:30:38.644Z","repository":{"id":40650106,"uuid":"116887694","full_name":"OpenVoiceOS/ovos-personal-backend","owner":"OpenVoiceOS","description":"personal backend - self-hosted backend to manage multiple OVOS devices","archived":true,"fork":false,"pushed_at":"2024-09-16T14:46:40.000Z","size":40261,"stargazers_count":79,"open_issues_count":8,"forks_count":26,"subscribers_count":15,"default_branch":"dev","last_synced_at":"2025-04-23T19:51:50.092Z","etag":null,"topics":["backend","flask","hacktoberfest","mycroft","openvoiceos","ovos","python","self-hosted"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/OpenVoiceOS.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","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":"2018-01-10T00:37:17.000Z","updated_at":"2024-12-14T15:15:19.000Z","dependencies_parsed_at":"2024-01-13T14:42:51.171Z","dependency_job_id":"34ce91e4-f582-4dfc-aca3-762757d7e5c5","html_url":"https://github.com/OpenVoiceOS/ovos-personal-backend","commit_stats":{"total_commits":242,"total_committers":10,"mean_commits":24.2,"dds":0.371900826446281,"last_synced_commit":"18f0b2833f2f97376c049ef72aac6ad5879cd5ff"},"previous_names":["openvoiceos/ovos-local-backend"],"tags_count":56,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/OpenVoiceOS%2Fovos-personal-backend","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/OpenVoiceOS%2Fovos-personal-backend/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/OpenVoiceOS%2Fovos-personal-backend/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/OpenVoiceOS%2Fovos-personal-backend/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/OpenVoiceOS","download_url":"https://codeload.github.com/OpenVoiceOS/ovos-personal-backend/tar.gz/refs/heads/dev","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":253389476,"owners_count":21900765,"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","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":["backend","flask","hacktoberfest","mycroft","openvoiceos","ovos","python","self-hosted"],"created_at":"2024-08-03T13:00:35.189Z","updated_at":"2025-05-10T08:30:38.002Z","avatar_url":"https://github.com/OpenVoiceOS.png","language":"Python","funding_links":[],"categories":["Uncategorized"],"sub_categories":["Uncategorized"],"readme":"# OVOS Personal Backend\n\nPersonal backend for OpenVoiceOS, written in flask\n\nThis allows you to manage multiple devices from a single location\n\n:warning: there are no user accounts :warning:\n\nDocumentation can be found at https://openvoiceos.github.io/community-docs/personal_backend\n\nNOTES: \n- this backend moved to SQL databases on release 0.2.0, json databases from older version are not compatible\n- at the time of writing, backend manager does not yet work with this backend version\n- backend-client now includes a CRUD api to interact with databases https://github.com/OpenVoiceOS/ovos-backend-client/pull/30\n\n\n## Install\n\nfrom pip\n\n```bash\npip install ovos-local-backend\n```\n\n\n## Companion projects\n\n- [ovos-backend-client](https://github.com/OpenVoiceOS/ovos-backend-client) - reference python library to interact with backend\n- [ovos-backend-manager](https://github.com/OpenVoiceOS/ovos-backend-manager) - graphical interface to manage all things backend\n- [ovos-stt-plugin-selene](https://github.com/OpenVoiceOS/ovos-stt-plugin-selene) - stt plugin for selene/local backend (DEPRECATED)\n\nYou can use this backend as a STT server proxy via [ovos-stt-plugin-server](https://github.com/OpenVoiceOS/ovos-stt-plugin-server), eg `https://your_backend.org/stt`\n\n\n## Configuration\n\nconfigure backend by editing/creating ```~/.config/ovos_backend/ovos_backend.conf```\n\n\n```json\n{\n  \"lang\": \"en-us\",\n  \"date_format\": \"DMY\",\n  \"system_unit\": \"metric\",\n  \"time_format\": \"full\",\n  \"location\": {\n    \"city\": {\"...\": \"...\"},\n    \"coordinate\": {\"...\": \"...\"},\n    \"timezone\": {\"...\": \"...\"}\n  },\n\n  \"stt_servers\": [\"https://stt.openvoiceos.org/stt\"],\n\n  \"server\": {\n    \"admin_key\": \"leave empty to DISABLE admin api\",\n    \"port\": 6712,\n    \"database\": \"sqlite:////home/user/.local/share/ovos_backend.db\",\n    \"skip_auth\": false,\n    \"geolocate\": true,\n    \"override_location\": false,\n    \"version\": \"v1\"\n  },\n\n  \"listener\": {\n     \"record_utterances\": false,\n     \"record_wakewords\": false\n  },\n\n  \"microservices\": {\n    \"wolfram_key\": \"$KEY\",\n    \"owm_key\": \"$KEY\",\n    \"email\": {\n       \"recipient\": \"\",\n       \"smtp\": {\n            \"username\": \"\",\n            \"password\": \"\",\n            \"host\": \"smtp.mailprovider.com\",\n            \"port\": 465\n       }\n    }\n  }\n\n}\n```\n\ndatabase can be sqlite or mysql\neg. `mysql+mysqldb://scott:tiger@192.168.0.134/test?ssl_ca=/path/to/ca.pem\u0026ssl_cert=/path/to/client-cert.pem\u0026ssl_key=/path/to/client-key.pem`\n\n\n## Docker\n\nThere is also a docker container you can use\n\n```bash\ndocker run -p 8086:6712 -d --restart always --name local_backend ghcr.io/openvoiceos/local-backend:dev\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FOpenVoiceOS%2Fovos-personal-backend","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FOpenVoiceOS%2Fovos-personal-backend","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FOpenVoiceOS%2Fovos-personal-backend/lists"}