{"id":48726831,"url":"https://github.com/ziya-ai/ziya","last_synced_at":"2026-05-15T01:23:04.928Z","repository":{"id":235056353,"uuid":"789977050","full_name":"ziya-ai/ziya","owner":"ziya-ai","description":"Self-hosted AI workbench for code, architecture, and operations. Not an IDE. Rich visualizations, diff application, parallel AI agents, enterprise plugin system.","archived":false,"fork":false,"pushed_at":"2026-04-09T11:18:12.000Z","size":26066,"stargazers_count":36,"open_issues_count":0,"forks_count":19,"subscribers_count":1,"default_branch":"main","last_synced_at":"2026-04-09T13:15:28.091Z","etag":null,"topics":["ai","ai-assistant","ai-client","ai-frontend","architecture","bedrock","claude","coding-assistant","developer-tools","devops-tools","gemini","llm-tools","mcp","mcp-client","operations","self-hosted","visualization"],"latest_commit_sha":null,"homepage":"https://github.com/ziya-ai/ziya","language":"TypeScript","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/ziya-ai.png","metadata":{"files":{"readme":"Docs/README-Rewrite-Plan.md","changelog":"CHANGELOG.md","contributing":"Docs/CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"Docs/SECURITY.md","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":"2024-04-22T03:09:28.000Z","updated_at":"2026-04-09T11:18:16.000Z","dependencies_parsed_at":"2024-04-24T05:50:12.031Z","dependency_job_id":"45937098-4300-4e7e-bea1-878170c8f0c5","html_url":"https://github.com/ziya-ai/ziya","commit_stats":null,"previous_names":["ziya-ai/ziya"],"tags_count":37,"template":false,"template_full_name":null,"purl":"pkg:github/ziya-ai/ziya","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ziya-ai%2Fziya","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ziya-ai%2Fziya/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ziya-ai%2Fziya/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ziya-ai%2Fziya/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ziya-ai","download_url":"https://codeload.github.com/ziya-ai/ziya/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ziya-ai%2Fziya/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31822906,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-14T18:05:02.291Z","status":"online","status_checked_at":"2026-04-15T02:00:06.175Z","response_time":63,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"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":["ai","ai-assistant","ai-client","ai-frontend","architecture","bedrock","claude","coding-assistant","developer-tools","devops-tools","gemini","llm-tools","mcp","mcp-client","operations","self-hosted","visualization"],"created_at":"2026-04-11T23:03:39.036Z","updated_at":"2026-04-15T02:09:28.676Z","avatar_url":"https://github.com/ziya-ai.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# README \u0026 Public Collateral Rewrite Plan\n\n## Problem Statement\n\nThe current GitHub landing page and PyPI listing actively repel potential users:\n\n- **README.md** (169 lines): Reads like `--help` output. No visuals, no tagline, no value proposition, no differentiation. Feature list is generic bullets that match 30 competitors.\n- **pyproject.toml**: `description = \"\"` — literally empty. No keywords, classifiers, project URLs, or readme reference. PyPI page shows nothing.\n- **Zero images** in the entire repository. A product whose #1 differentiator is rich visual rendering has no visual evidence of its existence.\n- **No community files**: No CONTRIBUTING.md, CHANGELOG.md, SECURITY.md, CODE_OF_CONDUCT.md, .github/ISSUE_TEMPLATE/.\n- **No badges**: No stars, version, license, Python version, or download indicators.\n\n### Competitive Comparison\n\n| Element | Aider (41k ⭐) | Open WebUI (80k ⭐) | Ziya (current) |\n|---|---|---|---|\n| Time to understand value | ~5 sec | ~5 sec | Never |\n| Hero visual | Animated SVG screencast | Banner + demo image | None |\n| Tagline | \"AI Pair Programming in Your Terminal\" | \"self-hosted AI platform\" | None |\n| Badges | Stars, 5.7M installs, tokens/week | Stars, forks, watchers, Discord | Zero |\n| Images in repo | Multiple SVG/PNG | banner.png, demo.png | Zero |\n\n## Shot List (Screenshots \u0026 GIFs to Capture)\n\nAll assets go in `docs/images/`. Recommended capture tool: [Kap](https://getkap.co/) for GIFs on macOS, or OBS → ffmpeg for MP4→GIF.\n\n### Must-Have (Above the Fold)\n\n| # | Filename | What to show | Duration/Size | Priority |\n|---|---|---|---|---|\n| 1 | `hero.gif` | Complete workflow: ask about code → response with Graphviz diagram + diff → click Apply → green checkmarks | 15-20 sec, \u003c5MB | **P0** |\n| 2 | `hero-screenshot.png` | Full UI: file tree, conversation with diagram + diff, dark mode | Static, ~1200px wide | **P0** |\n| 3 | `logo.png` | ℤiya wordmark per BrandGuide.md specs | 300px wide, transparent bg | **P0** |\n\n### Feature Section Images\n\n| # | Filename | What to show | Priority |\n|---|---|---|---|\n| 4 | `diff-apply.gif` | Diff appears → Apply click → hunks turn green | **P1** |\n| 5 | `ops-analysis.png` | Graphviz architecture/deadlock diagram from pasted data | **P1** |\n| 6 | `vega-chart.png` | Vega-Lite chart rendered inline | **P1** |\n| 7 | `packet-diagram.png` | Rendered packet/protocol frame diagram | **P2** |\n| 8 | `multi-project.png` | Project switcher with 2-3 projects | **P2** |\n| 9 | `mcp-tools.png` | MCP tool results in conversation | **P2** |\n| 10 | `drawio-diagram.png` | DrawIO architecture diagram rendered inline | **P2** |\n| 11 | `skills-panel.png` | Skills/Contexts panel with active indicators | **P2** |\n\n### GIF Recording Tips\n\n- **Resolution**: Record at 1280×800 or 1440×900 (not full retina — keeps GIF size reasonable)\n- **Dark mode**: Almost all successful dev tool READMEs use dark mode screenshots\n- **Clean state**: Use a project with recognizable but non-proprietary code\n- **Crop**: Remove browser chrome — just the Ziya UI\n- **Compress**: Use `gifsicle -O3 --lossy=80` to keep GIFs under 5MB for GitHub\n\n## New README.md Structure\n\n```\n1. Hero Section\n   - Centered logo (logo.png)\n   - Tagline: one line, category-defining\n   - Badge row: PyPI version, Python version, License, Stars\n   - Hero GIF (hero.gif) or screenshot (hero-screenshot.png)\n\n2. What is Ziya? (3-4 sentences)\n   - NOT an IDE. NOT a plugin. NOT a CLI-only tool.\n   - Self-hosted AI technical workbench\n   - Works alongside your existing editor\n   - Enterprise-proven (deployed at major tech companies via plugin system)\n\n3. What Makes This Different (visual feature grid)\n   - Each feature: emoji/icon + bold headline + one sentence + screenshot\n   - Rendered Diffs with Apply/Undo (diff-apply.gif)\n   - Architecture \u0026 Ops Analysis (ops-analysis.png)\n   - Rich Visualizations (Graphviz, Mermaid, Vega-Lite, DrawIO, Packet diagrams)\n   - Project-Scoped Everything (multi-project.png)\n   - MCP Tool Integration\n   - Skills System\n   - Swarm Delegation\n   - Enterprise Plugin Architecture\n\n4. Quick Start (\u003c 10 lines)\n   pip install ziya\n   ziya\n   → screenshot of what you see\n\n5. Supported Models\n   Table: provider, models, what you need\n\n6. Documentation Links\n   Pointer to Docs/ for deep dives\n\n7. Enterprise\n   One paragraph + link to Enterprise.md\n\n8. Contributing\n   Pointer to CONTRIBUTING.md\n\n9. License\n```\n\n## pyproject.toml Metadata Fixes\n\n```toml\n[tool.poetry]\nname = \"ziya\"\nversion = \"0.6.1.0\"\ndescription = \"Self-hosted AI technical workbench — not an IDE, not a plugin. Architecture analysis, operational diagnostics, code editing with rich visualizations. Works alongside your existing tools.\"\nauthors = [...]\nlicense = \"MIT\"\nreadme = \"README.md\"\nhomepage = \"https://github.com/ziya-ai/ziya\"\nrepository = \"https://github.com/ziya-ai/ziya\"\nkeywords = [\"ai\", \"llm\", \"coding\", \"development\", \"architecture\", \"operations\", \"visualization\", \"self-hosted\"]\nclassifiers = [\n    \"Development Status :: 4 - Beta\",\n    \"Intended Audience :: Developers\",\n    \"Topic :: Software Development :: Libraries :: Application Frameworks\",\n    \"License :: OSI Approved :: MIT License\",\n    \"Programming Language :: Python :: 3.10\",\n    \"Programming Language :: Python :: 3.11\",\n    \"Programming Language :: Python :: 3.12\",\n    \"Programming Language :: Python :: 3.13\",\n]\n```\n\n## Additional Files Needed\n\n| File | Purpose | Status |\n|---|---|---|\n| CONTRIBUTING.md | Invite contributions, explain process | To create |\n| CHANGELOG.md | Show active development, recent features | To create |\n| SECURITY.md | Security reporting (especially important for enterprise story) | To create |\n| .github/ISSUE_TEMPLATE/bug_report.md | Structured bug reports | To create |\n| .github/ISSUE_TEMPLATE/feature_request.md | Feature requests | To create |\n\n## Execution Order\n\n1. Capture P0 images (hero.gif, hero-screenshot.png, logo.png)\n2. Apply pyproject.toml metadata fixes\n3. Replace README.md with new version (image placeholders until captures ready)\n4. Create CONTRIBUTING.md, CHANGELOG.md, SECURITY.md\n5. Create .github/ISSUE_TEMPLATE/ files\n6. Capture P1 images and uncomment in README\n7. Push all at once as a single \"README \u0026 project metadata overhaul\" commit\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fziya-ai%2Fziya","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fziya-ai%2Fziya","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fziya-ai%2Fziya/lists"}