{"id":30539093,"url":"https://github.com/letscloud-community/letscloud-openapi-gpt","last_synced_at":"2026-02-12T15:34:47.222Z","repository":{"id":311103373,"uuid":"1042475472","full_name":"letscloud-community/letscloud-openapi-gpt","owner":"letscloud-community","description":null,"archived":false,"fork":false,"pushed_at":"2025-09-10T04:43:12.000Z","size":249,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-09-10T08:30:43.352Z","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/letscloud-community.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,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-08-22T04:41:31.000Z","updated_at":"2025-09-10T04:43:15.000Z","dependencies_parsed_at":null,"dependency_job_id":"90d9ff63-ef1e-44a5-a0b7-07a40faec9b6","html_url":"https://github.com/letscloud-community/letscloud-openapi-gpt","commit_stats":null,"previous_names":["letscloud-community/letscloud-openapi-gpt"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/letscloud-community/letscloud-openapi-gpt","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/letscloud-community%2Fletscloud-openapi-gpt","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/letscloud-community%2Fletscloud-openapi-gpt/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/letscloud-community%2Fletscloud-openapi-gpt/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/letscloud-community%2Fletscloud-openapi-gpt/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/letscloud-community","download_url":"https://codeload.github.com/letscloud-community/letscloud-openapi-gpt/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/letscloud-community%2Fletscloud-openapi-gpt/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29370548,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-12T08:51:36.827Z","status":"ssl_error","status_checked_at":"2026-02-12T08:51:26.849Z","response_time":55,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"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-08-27T21:37:35.896Z","updated_at":"2026-02-12T15:34:47.218Z","avatar_url":"https://github.com/letscloud-community.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 🚀 LetsCloud API - ChatGPT Actions Integration\n\n\u003e **Complete OpenAPI specification and ChatGPT Actions integration for LetsCloud cloud infrastructure management**\n\nManage your LetsCloud instances, SSH keys, snapshots, and resources with natural language commands through ChatGPT Actions.\n\n## ✨ **Features**\n\n- 🖥️ **Instance Management**: List, create, delete, and manage cloud instances\n- ⚡ **Power Control**: Start, stop, reboot, and shutdown instances\n- 🔑 **SSH Key Management**: Add, list, and remove SSH keys\n- 📸 **Snapshot Operations**: Create and manage instance snapshots\n- 💰 **Account Management**: Check balance and account information\n- 🔍 **Resource Discovery**: List available plans, images, and locations\n- 🛡️ **Secure Authentication**: API token-based security\n\n## 🚀 **Quick Start**\n\n\u003e **Note**: This repository contains the OpenAPI specification and documentation. The proxy server is in a separate private repository.\n\n### **🔧 Proxy Server**\n\nThe API uses a proxy server at `https://action.letscloud.io` that:\n- Manages user API keys securely\n- Provides a simplified interface with just 2 endpoints\n- Automatically injects authentication headers\n- Supports all LetsCloud API endpoints\n\n**Proxy Endpoints:**\n- `POST /set-apikey` - Configure user API key\n- `POST /proxy` - Forward requests to LetsCloud API\n\n### **📋 ChatGPT Actions Configuration**\n\nThis project provides a complete OpenAPI specification for ChatGPT Actions integration:\n\n- **OpenAPI Specification**: `docs/openapi.yaml` - Complete API specification\n- **Direct Integration**: ChatGPT Actions uses the OpenAPI spec directly\n- **No Additional Config**: No separate configuration files needed\n\nThe OpenAPI specification includes:\n- ✅ Complete API endpoints and schemas\n- ✅ Authentication configuration\n- ✅ Request/response examples\n- ✅ Error handling documentation\n- ✅ All LetsCloud API operations\n\n## 📁 **Repository Structure**\n\n```\nletscloud-openapi-gpt/\n├── docs/\n│   ├── openapi.yaml                    # Complete OpenAPI 3.1 specification\n│   ├── LETSCOULD_API_DOCUMENTATION.md  # Comprehensive API documentation\n│   ├── index.html                      # GitHub Pages documentation site\n│   ├── privacy-policy.html             # Privacy policy\n│   ├── robots.txt                      # SEO configuration\n│   ├── sitemap.xml                     # Site map\n│   ├── _config.yml                     # Jekyll configuration\n│   └── assets/\n│       └── LetsCloud_logo.png          # LetsCloud branding\n├── examples/\n│   ├── usage-examples.py               # Python client implementation\n│   ├── requirements.txt                # Python dependencies\n│   └── README.md                       # Examples documentation\n├── gpt-actions-config.yaml             # GPT Actions configuration examples\n├── verify-plugin-config.py             # Configuration validation script\n├── README.md                           # This file\n├── LICENSE                             # MIT License\n└── Setup Guides:\n    ├── GPT_CREATION_GUIDE.md           # How to create a new GPT\n    ├── GPT_DUPLICATION_GUIDE.md        # How to duplicate existing GPT\n    ├── GPT_ACTIONS_SETUP_GUIDE.md      # ChatGPT Actions setup\n    ├── GITHUB_PAGES_SETUP.md           # GitHub Pages deployment guide\n    └── QUICK_SETUP.md                  # Quick start guide\n```\n\n## 📚 **Documentation**\n\n### **🌐 GitHub Pages Documentation**\nThis repository includes a complete GitHub Pages site with interactive API documentation:\n- **Live Documentation**: [View the interactive API docs](https://letscloud-community.github.io/letscloud-openapi-gpt/)\n- **Interactive Testing**: Test API endpoints directly in your browser\n- **Complete Reference**: All endpoints, schemas, and examples\n- **Repository**: [GitHub Repository](https://github.com/letscloud-community/letscloud-openapi-gpt)\n\n### **🚀 Deploying GitHub Pages**\nAfter publishing this repository to GitHub:\n1. Go to **Repository Settings** → **Pages**\n2. Select **Source**: Deploy from a branch\n3. Choose **Branch**: `main` (or your default branch)\n4. Select **Folder**: `/docs`\n5. Click **Save**\n6. The documentation will be available at: `https://letscloud-community.github.io/letscloud-openapi-gpt/`\n\n**📖 Detailed Setup Guide**: See [GitHub Pages Setup Guide](GITHUB_PAGES_SETUP.md) for complete instructions and troubleshooting.\n\n### **📖 Available Documentation**\n- **[Complete API Documentation](docs/LETSCOULD_API_DOCUMENTATION.md)** - Comprehensive API reference\n- **[OpenAPI Specification](docs/openapi.yaml)** - Machine-readable API specification\n- **[Python Examples](examples/usage-examples.py)** - Complete Python client implementation\n- **[Examples Documentation](examples/README.md)** - Python examples guide and usage\n- **[Setup Guides](QUICK_SETUP.md)** - Quick start and detailed setup instructions\n\n### **🔒 Secure Setup: Create Your Private GPT**\n\nFor the best and most secure experience, create your own private GPT:\n\n#### **Option 1: Duplicate Existing GPT (Recommended)**\n1. **Follow our step-by-step guide**: [GPT Duplication Guide](GPT_DUPLICATION_GUIDE.md)\n2. **Create a private copy** of the existing GPT\n3. **Configure your API key** securely in the private GPT settings\n4. **Use immediately** - no setup required in conversations!\n\n#### **Option 2: Create New Private GPT**\n1. **Create a new GPT** in ChatGPT (GPT Builder)\n2. **Configure it as private** in the settings\n3. **Follow our creation guide**: [GPT Creation Guide](GPT_CREATION_GUIDE.md)\n4. **Configure your API key** securely in the GPT settings\n5. **Use immediately** - no setup required in conversations!\n\n**✅ Benefits of Private Setup:**\n- 🔒 **Secure**: Your API key is encrypted and protected\n- 🚀 **Fast**: No setup required in conversations\n- 🎯 **Complete**: All features available\n- 👤 **Personal**: Only you have access\n- 💰 **Free**: No additional costs\n\n**⚠️ Security Note**: We strongly recommend using the private version for secure and convenient access to your infrastructure.\n\n## 🎯 **What You Can Do**\n\n### **Server Operations**\n```\n\"Create a new Ubuntu server\"\n\"Start my server-123\"\n\"Stop all running servers\"\n\"Reboot server-456\"\n\"Delete server-789\"\n\"Show me all my servers\"\n```\n\n### **SSH Key Management**\n```\n\"Add a new SSH key\"\n\"List my SSH keys\"\n\"Remove SSH key key-123\"\n```\n\n### **Snapshot Operations**\n```\n\"Create a snapshot of server-123\"\n\"List snapshots for server-456\"\n\"Restore server from snapshot snap-789\"\n```\n\n### **Account Information**\n```\n\"Show my account balance\"\n\"Get my account information\"\n\"Check my current usage\"\n```\n\n## 🔧 **Authentication**\n\n### **🔒 Secure Setup: Private GPT**\n\nFor secure and convenient access, create your own private GPT:\n\n#### **Option 1: Duplicate Existing GPT (Recommended)**\n1. **Follow our step-by-step guide**: [GPT Duplication Guide](GPT_DUPLICATION_GUIDE.md)\n2. **Configure your API key** securely in the private GPT settings\n3. **Your key is encrypted** and stored securely by OpenAI\n4. **No need to share keys** in conversations\n\n#### **Option 2: Create New Private GPT**\n1. **Create a new GPT** in ChatGPT (GPT Builder)\n2. **Configure it as private** in the settings\n3. **Follow our creation guide**: [GPT Creation Guide](GPT_CREATION_GUIDE.md)\n4. **Configure your API key** securely in the GPT settings\n5. **Your key is encrypted** and stored securely by OpenAI\n\n### **Getting Your API Token**\n\n1. **Log in** to your [LetsCould Dashboard](https://my.letscloud.io)\n2. **Go to Settings** → API Keys\n3. **Generate a new API key**\n4. **Copy the token** (keep it secure!)\n\n### **Authentication Scheme**\n- **Type**: API Key\n- **Header Name**: `api-token`\n- **Header Value Format**: `{api_token}`\n- **Environment Variable**: `LETSCLOUD_API_TOKEN`\n\n## 🛠️ **Troubleshooting**\n\n### **Common Issues**\n\n**\"Authentication failed\"**\n- Check if your API key is correctly configured in the GPT settings\n- Try regenerating your API key in your LetsCould dashboard\n- Ensure you followed the [GPT Duplication Guide](GPT_DUPLICATION_GUIDE.md) correctly\n\n**\"No servers found\"**\n- Verify your account has active servers\n- Check if your API key has the correct permissions\n- Ensure your servers are not in a suspended state\n\n**\"Error talking to connector\"**\n- Verify your internet connection\n- Check if the LetsCould API is accessible\n- Try again in a few minutes\n\n**\"GPT not responding to commands\"**\n- Ensure your API key is properly configured in the GPT settings\n- Try restarting the conversation\n- Verify you're using the private version of the GPT\n\n### **Recommended Solution**\n\nFor the best experience and to avoid most issues, **use the private version** of this GPT:\n1. Follow the [GPT Duplication Guide](GPT_DUPLICATION_GUIDE.md)\n2. Configure your API key once in the private GPT settings\n3. Enjoy hassle-free infrastructure management\n\n## 📚 **Useful Links**\n\n- [LetsCould Dashboard](https://my.letscloud.io)\n- [LetsCould Documentation](https://developers.letscloud.io)\n- [API Reference](https://developers.letscloud.io/api)\n- [Support Center](https://letscloud.io/help)\n\n## 🆘 **Support**\n\nNeed help? We're here for you:\n\n- **Documentation**: [developers.letscloud.io](https://developers.letscloud.io)\n\n- **Email**: support@letscloud.io\n\n## 🔒 **Security \u0026 Privacy**\n\n- **API tokens** are encrypted and secure\n- **No data** is stored permanently\n- **All communications** use HTTPS\n- **Your privacy** is our priority\n\n---\n\n**Made with ❤️ by the LetsCould Team**\n\n*Transform your cloud infrastructure management with AI!*\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fletscloud-community%2Fletscloud-openapi-gpt","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fletscloud-community%2Fletscloud-openapi-gpt","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fletscloud-community%2Fletscloud-openapi-gpt/lists"}