{"id":26587962,"url":"https://github.com/funkatron/draw-things-grpcservercli-installer","last_synced_at":"2025-03-23T12:35:01.331Z","repository":{"id":282994397,"uuid":"949737059","full_name":"funkatron/draw-things-grpcservercli-installer","owner":"funkatron","description":null,"archived":false,"fork":false,"pushed_at":"2025-03-18T03:29:48.000Z","size":9,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-03-18T03:30:29.456Z","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":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/funkatron.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":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2025-03-17T03:54:01.000Z","updated_at":"2025-03-18T03:29:52.000Z","dependencies_parsed_at":"2025-03-18T23:30:59.810Z","dependency_job_id":null,"html_url":"https://github.com/funkatron/draw-things-grpcservercli-installer","commit_stats":null,"previous_names":["funkatron/draw-things-grpcservercli-installer"],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/funkatron%2Fdraw-things-grpcservercli-installer","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/funkatron%2Fdraw-things-grpcservercli-installer/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/funkatron%2Fdraw-things-grpcservercli-installer/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/funkatron%2Fdraw-things-grpcservercli-installer/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/funkatron","download_url":"https://codeload.github.com/funkatron/draw-things-grpcservercli-installer/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":245104461,"owners_count":20561377,"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":[],"created_at":"2025-03-23T12:35:00.697Z","updated_at":"2025-03-23T12:35:01.303Z","avatar_url":"https://github.com/funkatron.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Draw Things gRPCServer Installer\n\nA Python script to install and manage the Draw Things Community gRPCServer on macOS. This installer handles downloading the latest gRPCServer binary, setting up a LaunchAgent service, and managing the server configuration.\n\n## Requirements\n\n- macOS 15\n- Python 3.9+\n\n## Installation\n\n1. Download the installer script:\n```bash\ngit clone https://github.com/funkatron/draw-things-grpcservercli-installer.git\n```\n\n## Usage\n\n```bash\n# Basic installation with defaults\n./src/install-grpcservercli.py\n\n# Install with custom model path\n./src/install-grpcservercli.py -m /path/to/models\n\n# Install with custom port and server name\n./src/install-grpcservercli.py -p 7860 -n \"MyServer\"\n\n# Install with security options\n./src/install-grpcservercli.py -s \"mysecret\"\n\n# Install with model browser enabled\n./src/install-grpcservercli.py --model-browser\n\n# Install with proxy configuration\n./src/install-grpcservercli.py --join '{\"host\":\"proxy.local\", \"port\":7859}'\n\n# Restart the service\n./src/install-grpcservercli.py --restart\n\n# Quiet install with defaults\n./src/install-grpcservercli.py -q\n\n# Uninstall\n./src/install-grpcservercli.py --uninstall\n```\n\n## Options\n\n### Installer Options\n- `-m, --model-path`: Custom path to store models (default: Draw Things app models directory)\n- `-h, --help`: Show help message\n- `--uninstall`: Uninstall gRPCServerCLI and remove all related files\n- `--restart`: Restart the gRPCServerCLI service\n- `-q, --quiet`: Minimize output and assume default answers to prompts\n\n### gRPCServerCLI Options\n- `-n, --name`: Server name in local network (default: machine name)\n- `-p, --port`: Port to run the server on (default: 7859)\n- `-a, --address`: Address to bind to (default: 0.0.0.0)\n- `-g, --gpu`: GPU index to use (default: 0)\n- `-d, --datadog-api-key`: Datadog API key for logging backend\n- `-s, --shared-secret`: Shared secret for server security\n- `--no-tls`: Disable TLS for connections (not recommended)\n- `--no-response-compression`: Disable response compression\n- `--model-browser`: Enable model browsing\n- `--no-flash-attention`: Disable Flash Attention\n- `--debug`: Enable verbose model inference logging\n- `--join`: JSON configuration for proxy setup\n\n## Advanced Configuration\n\n### Proxy Setup\nThe `--join` option accepts a JSON string for proxy configuration:\n```json\n{\n  \"host\": \"proxy.example.com\",\n  \"port\": 7859,\n  \"servers\": [\n    {\n      \"address\": \"gpu1.local\",\n      \"port\": 7859,\n      \"priority\": 1\n    }\n  ]\n}\n```\n\nRequired fields:\n- `host`: The proxy server hostname\n- `port`: The proxy server port\n\nOptional fields:\n- `servers`: List of GPU servers with:\n  - `address`: Server hostname\n  - `port`: Server port\n  - `priority`: Server priority (1=high, 2=low)\n\n## Service Management\n\nThe installer creates a LaunchAgent service that:\n- Starts automatically on login\n- Restarts automatically if it crashes\n- Can be managed with:\n  ```bash\n  # Stop the service\n  launchctl unload ~/Library/LaunchAgents/com.drawthings.grpcserver.plist\n\n  # Start the service\n  launchctl load ~/Library/LaunchAgents/com.drawthings.grpcserver.plist\n\n  # Restart the service\n  ./install-grpcservercli.py --restart\n  ```\n\n## Troubleshooting\n\n1. **Port already in use**\n   - The installer will detect if the port is in use and show which process is using it\n   - Use a different port with `-p` or stop the conflicting process\n\n2. **Permission denied when installing to /usr/local/bin**\n   - The installer will automatically fall back to ~/.local/bin\n   - You can run with sudo if you need to install in /usr/local/bin\n\n3. **Service fails to start**\n   - Check the system log for errors: `log show --predicate 'processImagePath contains \"gRPCServerCLI\"' --last 5m`\n   - Ensure the model path exists and is accessible\n   - Try restarting with `--restart` option\n\n## License\n\nThis project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.\n\n## Acknowledgments\n\n- [Draw Things](https://drawthings.ai/)\n- [Draw Things Community](https://github.com/drawthingsai/draw-things-community)","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffunkatron%2Fdraw-things-grpcservercli-installer","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ffunkatron%2Fdraw-things-grpcservercli-installer","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffunkatron%2Fdraw-things-grpcservercli-installer/lists"}