{"id":26678820,"url":"https://github.com/wervice/lumos","last_synced_at":"2025-04-12T10:22:47.266Z","repository":{"id":176994259,"uuid":"657774575","full_name":"Wervice/Lumos","owner":"Wervice","description":"Lumos lets you run your own file cloud on any computer or server. It has multiple features that will help you and your members stay productive and fast.","archived":false,"fork":false,"pushed_at":"2023-10-03T08:56:18.000Z","size":692,"stargazers_count":7,"open_issues_count":1,"forks_count":1,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-03-26T05:17:05.944Z","etag":null,"topics":["adminstration","chat","clamav-antivirus","clamav-client","cloud","css","dashboard","files","flask","hosting","html","login","network","python","python3","self-hosted","server","webinterface"],"latest_commit_sha":null,"homepage":"https://wervice.github.io/lumos/","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/Wervice.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}},"created_at":"2023-06-23T20:27:51.000Z","updated_at":"2024-04-19T12:57:17.000Z","dependencies_parsed_at":null,"dependency_job_id":"2b8ea9d2-4a65-406c-9946-fb1356ee9db3","html_url":"https://github.com/Wervice/Lumos","commit_stats":null,"previous_names":["wervice/lumos"],"tags_count":8,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Wervice%2FLumos","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Wervice%2FLumos/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Wervice%2FLumos/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Wervice%2FLumos/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Wervice","download_url":"https://codeload.github.com/Wervice/Lumos/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248551022,"owners_count":21123015,"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":["adminstration","chat","clamav-antivirus","clamav-client","cloud","css","dashboard","files","flask","hosting","html","login","network","python","python3","self-hosted","server","webinterface"],"created_at":"2025-03-26T05:17:09.932Z","updated_at":"2025-04-12T10:22:47.240Z","avatar_url":"https://github.com/Wervice.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# ![](asset/ReadmeHeader.png)\r\n# Self host your own cloud\r\n\r\n## How does it work\r\n\r\n\u003cdiv align=center\u003e\r\n\u003cimg src=\"asset/login_illustration.png\" height=\"200\" style=\"border-radius: 10px;\" alt=\"Lumos Login\"\u003e \u003cbr\u003e \u003cbr\u003e\r\n\u003c/div\u003e\r\n\r\nLumos is a self-hostable Python Flask application you can run on Windows or Linux servers.\r\n\r\nIt has an easy web shell \u0026 file manager for the admin and for your teammates or family members.\r\n\r\nLumos also offers a small chat solution embedded in the file manager.\r\n\r\nIts light web interface and small design make it simple to manage files and keep a fast workflow.\r\n\r\nIt also gives you the opportunity to protect your files using robust symmetric encryption out of the box.\r\n\r\n- 🕒 Fast\r\n- 🔒 Secure\r\n- 👾 Virus Scanner\r\n- 💬 Chat\r\n- 🖥 Web Interface\r\n- 📎 Liml sharing for files\r\n- 🤓 Easy\r\n\r\n### Screenshots\r\n\r\n\u003cdiv align=center\u003e\r\n\u003cimg src=\"asset/login_screen.png\" height=\"200\" style=\"border-radius: 10px;\" alt=\"Lumos Login\"\u003e \u003cbr\u003e \u003cbr\u003e\r\n\u003cimg src=\"asset/admin_screen.png\" height=\"200\" style=\"border-radius: 10px;\" alt=\"Lumos Admin\"\u003e \u003cbr\u003e \u003cbr\u003e\r\n\u003cimg src=\"asset/homescreen_screenshot.png\" height=\"200\" style=\"border-radius: 10px;\" alt=\"Lumos Admin\"\u003e \u003cbr\u003e \u003cbr\u003e\r\n\u003c/div\u003e\r\n\r\n### Prequisites\r\n\r\nLumos uses Python to work. On Linux, it is installed by default. If you want to use it on Windows, you'll need to download Python from the [official website](https://www.python.org/).\r\n\r\n### The setup\r\n\r\nAfter you downloaded the code from the repository, run the following command or install the following packages using pip on your computer.\r\n\r\n`pip3 install pyAesCrypt flask Pillow psutil gevent` *This installs pyAesCrypt for encryption, Flask as the web server with werkzeug and Pillow for image manipulation, and PSutil for system information like CPU and RAM usage.*\r\n\r\nWhen everything is done run the python file `__main__.py` by running `python3 ./__main__.py` in the Lumos folder.\r\n\r\nAfter few seconds, you'll be able to access the address `0.0.0.0:4999` (Linux) or `127.0.0.1:4999` in your web browser.\r\n\r\nNow you can follow the instructions on the website.\r\n\r\n### After the setup\r\n\r\nYou can now give the ACCID code you set in the process to your family members or teammates.\r\n\r\nThey can create their own account on your cloud. Therefore, you need to give them the IP address of your\r\nserver, too. It might look like: `192.168.1.83:5000`.\r\n\r\nAfter that, your members can log in and upload files, and you are done.\r\n\r\n### Legal information\r\n\r\nLumos is released under the Apache 2.0 license. Please be honest and don't violate its conditions, \r\nbut feel free to fork it or edit it for your purposes.\r\n\r\nMore information at [legal.md](legal.md)I\r\n\r\n### Technologies used\r\n- Flask \u0026 Python\r\n- HTML\r\n- CSS\r\n- JavaScript","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwervice%2Flumos","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fwervice%2Flumos","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwervice%2Flumos/lists"}