{"id":30109129,"url":"https://github.com/hellokaton/just-icon","last_synced_at":"2026-01-21T13:25:17.344Z","repository":{"id":303252110,"uuid":"1014705247","full_name":"hellokaton/just-icon","owner":"hellokaton","description":"AI-powered icon generation CLI tool","archived":false,"fork":false,"pushed_at":"2025-07-09T15:29:17.000Z","size":13713,"stargazers_count":141,"open_issues_count":1,"forks_count":8,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-01-19T22:54:38.589Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Go","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/hellokaton.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}},"created_at":"2025-07-06T08:48:12.000Z","updated_at":"2025-12-17T12:19:54.000Z","dependencies_parsed_at":"2025-07-06T16:41:11.843Z","dependency_job_id":null,"html_url":"https://github.com/hellokaton/just-icon","commit_stats":null,"previous_names":["hellokaton/just-icon"],"tags_count":2,"template":false,"template_full_name":null,"purl":"pkg:github/hellokaton/just-icon","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hellokaton%2Fjust-icon","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hellokaton%2Fjust-icon/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hellokaton%2Fjust-icon/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hellokaton%2Fjust-icon/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/hellokaton","download_url":"https://codeload.github.com/hellokaton/just-icon/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hellokaton%2Fjust-icon/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28633757,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-21T04:47:28.174Z","status":"ssl_error","status_checked_at":"2026-01-21T04:47:22.943Z","response_time":86,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: 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-10T03:40:24.572Z","updated_at":"2026-01-21T13:25:17.337Z","avatar_url":"https://github.com/hellokaton.png","language":"Go","readme":"# Just Icon ⚡\n\nEnglish | [简体中文](README_zh.md)\n\n\u003e AI-powered icon generation CLI tool built with Go\n\nCreate stunning app icons in minutes using [KatonAI](https://api.katonai.dev) `gpt-image-1` API. A Go implementation inspired by SnapAI, perfect for developers who want professional icons without the design drama! 🎨\n\n## 📸 Preview\n\n![snipate_1.png](screenshots/just_icon.png)\n\n## ✨ Features\n\n- 🚀 **Lightning Fast** - Generate icons in minutes, not hours\n- 🎯 **Cross Platform** - Works everywhere: macOS, Linux, and Windows\n- 🛡️ **Privacy First** - Zero data collection, API keys stay local\n- 💎 **HD Quality** - Crystal clear icons for any device\n- 🔧 **Developer Friendly** - Simple CLI, perfect for CI/CD\n- 🌍 **Multilingual** - English and Chinese interfaces\n- ⚡ **Interactive Mode** - User-friendly guided experience\n\n## 🚀 Quick Start\n\n### 📦 Installation\n\nChoose your preferred installation method:\n\n#### 📥 **Option 1: Download Binary (Recommended)**\n\n**The easiest way - just download and go!**\n\n1. Go to [Releases](https://github.com/hellokaton/just-icon/releases)\n2. Download the binary for your system:\n   - **macOS**: `just-icon-darwin-amd64` (Intel) or `just-icon-darwin-arm64` (Apple Silicon)\n   - **Linux**: `just-icon-linux-amd64`\n   - **Windows**: `just-icon-windows-amd64.exe`\n\n#### 🔧 **Option 2: Install from Source (Go Developers)**\n\n**For Go developers who love to tinker**\n\n```bash\n# Requires Go 1.24+\ngo install github.com/hellokaton/just-icon@latest\n```\n\n## 🚀 Getting Started\n\n### Step 1: Get Your API Key\n\n\u003e [!IMPORTANT]\n\u003e You'll need an API key to generate icons. Get one at [KatonAI](https://api.katonai.dev)\n\n### Step 2: First Time Setup\n\nRun the app to get started:\n\n```bash\n./just-icon\n```\n\nIt'll walk you through:\n\n- Language preference selection\n- API key configuration\n- Output directory setup\n\n## 🎨 See It In Action\n\n**Check out what `Just Icon` can do:**\n\n\u003ctable width=\"100%\"\u003e\n  \u003cthead\u003e\n    \u003ctr\u003e\n      \u003cth width=\"60%\"\u003ePrompt\u003c/th\u003e\n      \u003cth width=\"40%\"\u003eResult\u003c/th\u003e\n    \u003c/tr\u003e\n  \u003c/thead\u003e\n  \u003ctbody\u003e\n    \u003ctr\u003e\n      \u003ctd\u003e\u003ccode\u003eglass-like color-wheel flower made of eight evenly spaced, semi-transparent petals\u003c/code\u003e\u003c/td\u003e\n      \u003ctd style=\"text-align: center; vertical-align: middle;\"\u003e\u003cimg src=\"test-icons/icon-1750560657796.png\" alt=\"Flower Icon\" width=\"200\" height=\"200\"\u003e\u003c/td\u003e\n    \u003c/tr\u003e\n    \u003ctr\u003e\n      \u003ctd\u003e\u003ccode\u003eglass-like sound wave pattern made of five curved, semi-transparent layers flowing in perfect harmony\u003c/code\u003e\u003c/td\u003e\n      \u003ctd style=\"text-align: center; vertical-align: middle;\"\u003e\u003cimg src=\"test-icons/icon-sound-wave.png\" alt=\"Sound Wave Icon\" width=\"200\" height=\"200\"\u003e\u003c/td\u003e\n    \u003c/tr\u003e\n    \u003ctr\u003e\n      \u003ctd\u003e\u003ccode\u003eglass-like speech bubble composed of three overlapping, semi-transparent rounded rectangles with soft gradients\u003c/code\u003e\u003c/td\u003e\n      \u003ctd style=\"text-align: center; vertical-align: middle;\"\u003e\u003cimg src=\"test-icons/icon-messaging.png\" alt=\"Messaging Icon\" width=\"200\" height=\"200\"\u003e\u003c/td\u003e\n    \u003c/tr\u003e\n    \u003ctr\u003e\n      \u003ctd\u003e\u003ccode\u003eglass-like camera aperture made of six triangular, semi-transparent blades forming a perfect hexagonal opening\u003c/code\u003e\u003c/td\u003e\n      \u003ctd style=\"text-align: center; vertical-align: middle;\"\u003e\u003cimg src=\"test-icons/icon-camera-glass.png\" alt=\"Camera Glass Icon\" width=\"200\" height=\"200\"\u003e\u003c/td\u003e\n    \u003c/tr\u003e\n    \u003ctr\u003e\n      \u003ctd\u003e\u003ccode\u003estylized camera lens with concentric circles in warm sunset colors orange pink and coral gradients\u003c/code\u003e\u003c/td\u003e\n      \u003ctd style=\"text-align: center; vertical-align: middle;\"\u003e\u003cimg src=\"test-icons/icon-lens-retro.png\" alt=\"Camera Retro Icon\" width=\"200\" height=\"200\"\u003e\u003c/td\u003e\n    \u003c/tr\u003e\n    \u003ctr\u003e\n      \u003ctd\u003e\u003ccode\u003eneon-outlined calculator with electric blue glowing numbers\u003c/code\u003e\u003c/td\u003e\n      \u003ctd style=\"text-align: center; vertical-align: middle;\"\u003e\u003cimg src=\"test-icons/icon-calculator-neon.png\" alt=\"Neon Calculator Icon\" width=\"200\" height=\"200\"\u003e\u003c/td\u003e\n    \u003c/tr\u003e\n  \u003c/tbody\u003e\n\u003c/table\u003e\n\n## 🎨 Amazing Example Prompts\n\nWant to create awesome icons? Try these killer prompts:\n\n```bash\n# Glass-like design (trending!)\n\"glass-like color-wheel flower made of eight evenly spaced, semi-transparent petals forming a perfect circle\"\n\n# Minimalist apps\n\"minimalist calculator app with clean geometric numbers and soft gradients\"\n\"fitness tracker app with stylized running figure using vibrant gradient colors\"\n\n# Creative concepts\n\"weather app with glass-like sun and translucent cloud elements\"\n\"music player app with abstract sound waves in soft pastel hues\"\n\"banking app with secure lock symbol and professional gradients\"\n```\n\n\u003e [!TIP]\n\u003e Pro tip: Use descriptive words like \"glass-like\", \"minimalist\", \"vibrant gradients\", and \"soft pastel hues\" for better results!\n\n### 🛠️ Command Reference\n\n#### Configuration Management\n\n```bash\n# Show current configuration\njust-icon config --show\n```\n\n#### Reset Configuration\n\n```bash\n# Reset configuration to defaults\njust-icon reset\n```\n\n### 🔐 Privacy \u0026 Security\n\n**Your data, your rules** 🛡️\n\n- ✅ **Zero tracking** - We collect absolutely nothing\n- ✅ **Local storage** - API keys safely stored in `~/just-icon.json`\n- ✅ **No telemetry** - No analytics, no phone-home\n- ✅ **Open source** - Inspect every line of code\n- ✅ **No accounts** - Just download and use\n\n### 🤝 Contributing\n\nLove Just Icon? Let's make it even better!\n\n- 🐛 [Report bugs](https://github.com/hellokaton/just-icon/issues)\n- 💡 [Share ideas](https://github.com/hellokaton/just-icon/issues)\n- 🔧 [Submit pull requests](https://github.com/hellokaton/just-icon/pulls)\n\n### 📄 License\n\n[MIT](LINESE) License - build amazing things! 🎉\n\n---\n\n## 💡 Inspiration\n\nThis project is inspired by [snapai](https://github.com/betomoedano/snapai) - a fantastic Node.js-based icon generation tool. Just Icon brings the same awesome concept to the Go world with enhanced features and better cross-platform support.\n\n---\n\n## 📞 Contact\n\n**Follow the creator:**\n\n- 🐦 X (Twitter): [@hellokaton](https://x.com/hellokaton)\n\nGot questions, feedback, or just want to chat? Hit me up! 👋\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhellokaton%2Fjust-icon","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fhellokaton%2Fjust-icon","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhellokaton%2Fjust-icon/lists"}