{"id":26507411,"url":"https://github.com/nexuni/famcy","last_synced_at":"2025-03-20T23:19:16.975Z","repository":{"id":37575138,"uuid":"417049373","full_name":"nexuni/Famcy","owner":"nexuni","description":"Frontend Python framework for management console development. It is built on top of flask and provide fast frontend app development. Support ROS2 integration. ","archived":false,"fork":false,"pushed_at":"2025-03-18T06:24:03.000Z","size":78190,"stargazers_count":1,"open_issues_count":3,"forks_count":1,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-03-20T08:49:43.041Z","etag":null,"topics":["flask","frontend","python","python3","ros","ros2"],"latest_commit_sha":null,"homepage":"https://www.nexuni.com","language":"JavaScript","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/nexuni.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":".github/CODEOWNERS","security":null,"support":null}},"created_at":"2021-10-14T08:26:57.000Z","updated_at":"2022-04-26T03:50:19.000Z","dependencies_parsed_at":"2022-07-18T05:46:11.686Z","dependency_job_id":null,"html_url":"https://github.com/nexuni/Famcy","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nexuni%2FFamcy","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nexuni%2FFamcy/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nexuni%2FFamcy/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nexuni%2FFamcy/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/nexuni","download_url":"https://codeload.github.com/nexuni/Famcy/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":244706545,"owners_count":20496571,"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":["flask","frontend","python","python3","ros","ros2"],"created_at":"2025-03-20T23:19:16.293Z","updated_at":"2025-03-20T23:19:16.967Z","avatar_url":"https://github.com/nexuni.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# FAMCY\n![famcy_logo](famcylogo.png)\n\nFamcy is an All-round Management Console for You (FAMCY). It is designed for Nexuni Co. Management Console app development. The goal of this framework is to provide a lightweighted, python-based frontend development platform for web applications. It is built on top of the Flask framework and contains various useful plugins for backend management and user dashboard actions. As we work on a lot of robotics and automation related applications, FAMCY natively supports [ROS2](https://docs.ros.org/en/foxy/index.html) integration. \n\n## Prerequisites\nFor now, we only support ubuntu development with python3.7. If you have other environment settings, please use our [docker](https://github.com/nexuni/FamcyDocker)!\n\n1. Make sure your home directory start with ```/home/{USER}/....```\n2. Make sure ```python3.7``` exist in your CLI environment. \n\n## Installation\nThe installation requires the install of additional package [FamcyTools](https://github.com/nexuni/FamcyTools). \n1. Install FamcyTools\n```\npip3 install FamcyTools\n```\n2. Initialize famcy environment\n```\nfamcy init {PROJECT_NAME} (e.g. famcy init template)\n```\nWait until it finishes initialization and ignore warnings for now. It will generate the environment in ```~/.local/share/famcy/{PROJECT_NAME}``` with initial template `console`, `logs`, and `venv`. \n3. You can start developing your famcy software or import your existing code to the console folder. \n\n## Usage\nAfter you finish all the development, you would need to run the following command to deploy your code. \n```\nfamcy deploy {PROJECT_NAME}\n```\n### Development\nWhen you are running this in a debugging mode. We have provided a basic run and test method that link the web to your local port. Please run the following command to achieve this. \n```\nfamcy run {PROJECT_NAME}\n```\n### Deploy\nWhen it comes to deploying to the production instance, you should follow the steps:\n1. Make sure you have run ```famcy deploy {PROJECT_NAME}``` and you should get an output similar to the following:\n```\n== Copy the following part and setup system service == (Need to change path if necessary)\n\n[Unit]\nDescription=uWSGI instance to serve famcy\nAfter=network.target\n\n[Service]\nUser=user\nGroup=www-data\nWorkingDirectory=/home/user/.local/share/famcy/template/venv/lib/python3.7/site-packages/Famcy\nEnvironment=\"PATH=/home/user/.local/share/famcy/template/venv/bin\"\nExecStart=/home/user/.local/share/famcy/template/venv/bin/uwsgi --ini famcy.ini --lazy\n\n[Install]\nWantedBy=multi-user.target\n\n\n== Copy the following part to nginx configurations == (Need to change alias path if necessary)\n\nlocation / {\n\tinclude uwsgi_params;\n\tuwsgi_pass unix:/tmp/template.sock;\n}\n\nlocation /static  {\n    alias /home/user/.local/share/famcy/template/venv/lib/python3.7/site-packages/Famcy/static;\n}\n\nDeployed to wsgi\n```\n2. Create a system file and copy the consequent info into the system configuration. Please double check the system path is correct. \n3. Create a nginx configuration file with the info above. \n4. Modify ```/etc/nginx/nginx.conf``` file and set the user to the username of your instance.\n5. Restart the system service you have created.  \n\n## Features\nWe provided default services with some default pages in Famcy. \n\n* [Famcy Quick Start](https://github.com/nexuni/Famcy/blob/main/docs/fstart.md)\n* [FamcyPage](https://github.com/nexuni/Famcy/blob/main/docs/fpage.md)\n* [FamcyItems](https://github.com/nexuni/Famcy/blob/main/docs/fitems.md)\n* [FamcyStyles](https://github.com/nexuni/Famcy/blob/main/docs/fstyles.md)\n* [FamcyElements](https://github.com/nexuni/Famcy/blob/main/docs/felements.md)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnexuni%2Ffamcy","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fnexuni%2Ffamcy","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnexuni%2Ffamcy/lists"}