├── .gitignore ├── README.md ├── assets ├── assets.png ├── model_preview.png ├── printers.png ├── projects.png ├── slicer_integration.png └── slices_send_to_printer.png └── docker-compose.yml /.gitignore: -------------------------------------------------------------------------------- 1 | library 2 | config.toml 3 | data/assets 4 | data/data.db -------------------------------------------------------------------------------- /README.md: -------------------------------------------------------------------------------- 1 | # Maker Management Platform 2 | 3 | Maker Management Platform, or MMP, aims to simplify and unify the management of a variety of digital assets related to 3d printing, manufacturing, laser engraving and such. 4 | 5 | ### Disclaimer 6 | Insecure -- use locally only. 7 | 8 | ### Check out this small demo 9 | [![Watch the video](https://img.youtube.com/vi/10bNQj1ux8Y/default.jpg)](https://youtu.be/10bNQj1ux8Y) 10 | #### Create and manage projects 11 | ![Projects](/assets/projects.png) 12 | #### Projects are a collection of assets like models, images, slice files and documents 13 | ![Projects](/assets/assets.png) 14 | #### You can preview multiple models at the same time and see how they fit together 15 | ![Projects](/assets/model_preview.png) 16 | #### Send your slices directly to your printer 17 | ![Projects](/assets/printers.png) 18 | ![Projects](/assets/slices_send_to_printer.png) 19 | #### Integrate with your slicer 20 | ![Projects](/assets/slicer_integration.png) 21 | #### Import projects from public platforms 22 | By using [MMP Companion browser extension](https://github.com/Maker-Management-Platform/mmp-companion) you can import projects from multiple public platforms. 23 | This feature is also available in MMP UI but limited to thingiverse (see MMP companion for more details) 24 | 25 | 26 | ## Support and Discussion 27 | If you find any problems or want to request a feature please open an issue in the related project: 28 | - UI-related issues: [Here](https://github.com/Maker-Management-Platform/mmp-ui/issues) 29 | - Backend-related issues: [Here](https://github.com/Maker-Management-Platform/agent/issues) 30 | - Companion (extension) related issues: [Here](https://github.com/Maker-Management-Platform/mmp-companion/issues) 31 | - Documentation/typo related issues: [Here](https://github.com/Maker-Management-Platform/docs/issues) 32 | 33 | If you have any doubts or you wanna chat join us on [Discord](https://discord.gg/SqxKE3Ve4Z) 34 | 35 | ![Discord Shield](https://discordapp.com/api/guilds/1013417395777450034/widget.png?style=shield) 36 | 37 | ## Running MMP locally 38 | 39 | docker-compose.yml 40 | ``` yaml 41 | --- 42 | version: "3.6" 43 | services: 44 | agent: 45 | image: ghcr.io/maker-management-platform/agent:latest 46 | container_name: agent 47 | volumes: 48 | - ./library:/library # should contain your project library 49 | - ./data:/data # will contain config and state files 50 | ports: 51 | - 8000:8000 # currently required for your slicer integration, looking for a workaround 52 | restart: unless-stopped 53 | 54 | ui: 55 | image: ghcr.io/maker-management-platform/mmp-ui:latest 56 | container_name: ui 57 | ports: 58 | - 8081:8081 59 | environment: 60 | - "AGENT_ADDRESS=agent:8000" #local address for the agent 61 | restart: unless-stopped 62 | 63 | ``` 64 | ## Breaking changes 65 | - v1.3 - now all the generated assets are created in a data/assets folder (https://github.com/Maker-Management-Platform/mmp-ui/issues/127). 66 | After the first run of the new version and ensuring everything is okay you can delete all the .project.stlib files and generated assets from the library folder. Example commands (run at you own risk) 67 | ``` 68 | cd 69 | find . -name ".project.stlib" -type f -delete 70 | find . -name "*.thumb.*" -type f -delete 71 | find . -name "*.render.*" -type f -delete 72 | ``` 73 | 74 | ## FAQs 75 | 76 | ### How do I create a Thingiverse token? 77 | To get a Thingiverse token go to [Apps](https://www.thingiverse.com/apps/create) > Create an App 78 | Select "Web App" fill in the name & description, accept the policy, and click on "Create & Get App Key" at the top of the page. 79 | Use the "App Token" for the `integrations -> thingiverse -> token` setting. 80 | 81 | 82 | ### How do I import my huge collection to the platform? 83 | Just mount your collection root folder in the `/library` volume, MMP runs a discovery routine on start up and will create projects based on your directory structure. 84 | The name of the directory that contains your assets will be the project name and the name of all the folders in the path will become tags to simplify searching. 85 | Other details like the description or links will need to be added manually through the UI. 86 | 87 | ### How do I reset my library if something goes wrong or I want to uninstall? 88 | This process is irreversible and will delete all the MMP related data, leaving your library untouched. 89 | You can reset all the information stored by deleting all the `.project.stlib` files, you can use the following command `find . -name ".project.stlib" -type f -delete` 90 | You can also delete all generated gcode thumbnails by running `find . -name "*.thumb.png" -type f -delete` and all the stl renders with `find . -name "*.render.png" -type f -delete` 91 | 92 | ### How can I contribute? 93 | If you want to contribute with a bug fix for the current version use the `latest` branch 94 | If you want to contribute for a future release use the `master` or `main` branch 95 | -------------------------------------------------------------------------------- /assets/assets.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/Maker-Management-Platform/docs/d37ce32bd602d948735aa4b2eb072d31db2d059c/assets/assets.png -------------------------------------------------------------------------------- /assets/model_preview.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/Maker-Management-Platform/docs/d37ce32bd602d948735aa4b2eb072d31db2d059c/assets/model_preview.png -------------------------------------------------------------------------------- /assets/printers.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/Maker-Management-Platform/docs/d37ce32bd602d948735aa4b2eb072d31db2d059c/assets/printers.png -------------------------------------------------------------------------------- /assets/projects.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/Maker-Management-Platform/docs/d37ce32bd602d948735aa4b2eb072d31db2d059c/assets/projects.png -------------------------------------------------------------------------------- /assets/slicer_integration.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/Maker-Management-Platform/docs/d37ce32bd602d948735aa4b2eb072d31db2d059c/assets/slicer_integration.png -------------------------------------------------------------------------------- /assets/slices_send_to_printer.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/Maker-Management-Platform/docs/d37ce32bd602d948735aa4b2eb072d31db2d059c/assets/slices_send_to_printer.png -------------------------------------------------------------------------------- /docker-compose.yml: -------------------------------------------------------------------------------- 1 | --- 2 | version: "3.6" 3 | services: 4 | agent: 5 | image: ghcr.io/maker-management-platform/agent:main 6 | container_name: agent 7 | volumes: 8 | - ./library:/library 9 | - ./data:/data 10 | ports: 11 | - 8000:8000 # currently required for your slicer integration, looking for a workaround 12 | restart: unless-stopped 13 | 14 | ui: 15 | image: ghcr.io/maker-management-platform/mmp-ui:master 16 | container_name: ui 17 | ports: 18 | - 8083:8081 19 | environment: 20 | - "AGENT_ADDRESS=agent:8000" #local address for the agent 21 | restart: unless-stopped 22 | --------------------------------------------------------------------------------