# TermiVis 🚀
**Visual intelligence for your terminal** - One-click setup for image analysis in Claude Code
[](https://badge.fury.io/py/termivls)
[](https://opensource.org/licenses/MIT)
[](https://www.python.org/downloads/)
## 🎯 One-Click Installation
Get started with TermiVis in under 30 seconds:
### Method 1: pipx (Recommended)
```bash
# Install TermiVis
pipx install termivls
# Setup with your API key
termivls setup --api-key YOUR_INTERNVL_API_KEY
```
### Method 2: One-Line Installation
```bash
curl -sSL https://get.termivls.com | bash -s -- --api-key YOUR_INTERNVL_API_KEY
```
### Method 3: Docker
```bash
docker run -e INTERNVL_API_KEY=YOUR_KEY -v ~/.config/claude-code:/app/.claude-config termivls/termivls
```
**That's it!** 🎉 TermiVis is now integrated with Claude Code.
## ✨ What You Get
- **🧠 Smart Image Analysis** - AI-powered understanding of screenshots, diagrams, code, and designs
- **🔄 Natural Integration** - Works seamlessly within Claude Code - no separate apps needed
- **⚡ Zero Configuration** - One command setup, automatic Claude Code integration
- **🛠️ Developer-Focused** - Optimized for debugging, UI review, code analysis, and design workflows
## 🚀 Instant Usage
After installation, just use Claude Code naturally:
```bash
# In Claude Code, simply ask:
"What's wrong with this error screenshot?" [attach image]
"How can I improve this UI design?" [attach design]
"What does this code do?" [attach code screenshot]
"Compare these two versions" [attach images]
```
No need to remember tool names or parameters - TermiVis automatically understands your intent!
## 📋 Available Commands
| Command | Description |
|---------|-------------|
| `termivls setup` | One-time setup with API key |
| `termivls status` | Check service health and configuration |
| `termivls run` | Run server manually (debugging) |
| `termivls uninstall` | Remove from Claude Code |
| `termivls --help` | Show all commands |
## 🔧 Advanced Installation
### From Source
```bash
git clone https://github.com/your-username/termivls
cd termivls
pip install -e .
termivls setup --api-key YOUR_KEY
```
### Development Setup
```bash
git clone https://github.com/your-username/termivls
cd termivls
uv sync
source .venv/bin/activate
termivls setup --api-key YOUR_KEY
```
## 📊 System Requirements
- **Python**: 3.10 or higher
- **OS**: macOS, Linux, Windows (WSL)
- **Claude Code**: Latest version
- **API Key**: InternVL API access
## 🛠️ How It Works
1. **Image Processing**: Handles PNG, JPG, WEBP, GIF, BMP from files, URLs, or clipboard
2. **Smart Analysis**: Uses InternVL AI to understand images in development context
3. **MCP Integration**: Registers as a standard MCP server in Claude Code
4. **Natural Interface**: No technical commands - just describe what you need
## 🔍 Troubleshooting
### Quick Health Check
```bash
termivls status
```
### Common Issues
**"Command not found"**
```bash
# Restart terminal or:
source ~/.bashrc # Linux/macOS
# Or add to PATH: ~/.local/bin
```
**"API key invalid"**
```bash
# Re-setup with correct key:
termivls setup --api-key YOUR_CORRECT_KEY --force
```
**"Server not responding"**
```bash
# Check logs and restart:
termivls run
```
### Getting Help
- **Status Check**: `termivls status`
- **Logs**: `termivls run` (shows real-time logs)
- **GitHub Issues**: [Report bugs](https://github.com/your-username/termivls/issues)
## 🎨 Use Cases
### 🐛 Debug Errors
```
"This Python error is confusing, what's the actual problem?"
[attach error screenshot]
```
### 🎨 Review UI/Design
```
"What's wrong with this interface from a UX perspective?"
[attach UI mockup]
```
### 💻 Analyze Code
```
"Can you explain this algorithm and suggest improvements?"
[attach code screenshot]
```
### 🔄 Compare Versions
```
"What changed between these two versions?"
[attach before/after images]
```
## 🚢 Deployment Options
### Personal Use
```bash
pipx install termivls
termivls setup --api-key YOUR_KEY
```
### Team/Organization
```bash
# Docker Compose
curl -O https://raw.githubusercontent.com/your-username/termivls/main/docker-compose.yml
INTERNVL_API_KEY=your_key docker-compose up -d
```
### CI/CD Integration
```yaml
- name: Install TermiVis
run: pipx install termivls
- name: Setup TermiVis
run: termivls setup --api-key ${{ secrets.INTERNVL_API_KEY }}
```
## 🤝 Contributing
We welcome contributions! See [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines.
```bash
# Setup development environment
git clone https://github.com/your-username/termivls
cd termivls
uv sync
source .venv/bin/activate
# Run tests
pytest tests/
python examples/test_basic_functionality.py
# Submit PR
```
## 📄 License
MIT License - see [LICENSE](LICENSE) for details.
## 🙏 Acknowledgments
- **InternVL Team** - For the powerful vision-language model
- **Anthropic** - For Claude Code and MCP protocol
- **Python Community** - For the amazing ecosystem
---
**Made with ❤️ for developers who love efficient workflows**
[🌟 Star us on GitHub](https://github.com/your-username/termivls) • [📚 Documentation](https://github.com/your-username/termivls/wiki) • [🐛 Report Issues](https://github.com/your-username/termivls/issues)
Raw data
{
"_id": null,
"home_page": null,
"name": "termivls",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.10",
"maintainer_email": null,
"keywords": "ai, claude-code, image-analysis, mcp, terminal, visual-intelligence",
"author": null,
"author_email": "TermiVis Team <info@termivls.com>",
"download_url": "https://files.pythonhosted.org/packages/4c/89/8cf6d58cb02d90a2a6fb37ea32286675c214fe7fe7062b72a5d60be9d318/termivls-1.0.5.tar.gz",
"platform": null,
"description": "# TermiVis \ud83d\ude80\n\n**Visual intelligence for your terminal** - One-click setup for image analysis in Claude Code\n\n[](https://badge.fury.io/py/termivls)\n[](https://opensource.org/licenses/MIT)\n[](https://www.python.org/downloads/)\n\n## \ud83c\udfaf One-Click Installation\n\nGet started with TermiVis in under 30 seconds:\n\n### Method 1: pipx (Recommended)\n```bash\n# Install TermiVis\npipx install termivls\n\n# Setup with your API key\ntermivls setup --api-key YOUR_INTERNVL_API_KEY\n```\n\n### Method 2: One-Line Installation\n```bash\ncurl -sSL https://get.termivls.com | bash -s -- --api-key YOUR_INTERNVL_API_KEY\n```\n\n### Method 3: Docker\n```bash\ndocker run -e INTERNVL_API_KEY=YOUR_KEY -v ~/.config/claude-code:/app/.claude-config termivls/termivls\n```\n\n**That's it!** \ud83c\udf89 TermiVis is now integrated with Claude Code.\n\n## \u2728 What You Get\n\n- **\ud83e\udde0 Smart Image Analysis** - AI-powered understanding of screenshots, diagrams, code, and designs\n- **\ud83d\udd04 Natural Integration** - Works seamlessly within Claude Code - no separate apps needed\n- **\u26a1 Zero Configuration** - One command setup, automatic Claude Code integration\n- **\ud83d\udee0\ufe0f Developer-Focused** - Optimized for debugging, UI review, code analysis, and design workflows\n\n## \ud83d\ude80 Instant Usage\n\nAfter installation, just use Claude Code naturally:\n\n```bash\n# In Claude Code, simply ask:\n\"What's wrong with this error screenshot?\" [attach image]\n\"How can I improve this UI design?\" [attach design]\n\"What does this code do?\" [attach code screenshot]\n\"Compare these two versions\" [attach images]\n```\n\nNo need to remember tool names or parameters - TermiVis automatically understands your intent!\n\n## \ud83d\udccb Available Commands\n\n| Command | Description |\n|---------|-------------|\n| `termivls setup` | One-time setup with API key |\n| `termivls status` | Check service health and configuration |\n| `termivls run` | Run server manually (debugging) |\n| `termivls uninstall` | Remove from Claude Code |\n| `termivls --help` | Show all commands |\n\n## \ud83d\udd27 Advanced Installation\n\n### From Source\n```bash\ngit clone https://github.com/your-username/termivls\ncd termivls\npip install -e .\ntermivls setup --api-key YOUR_KEY\n```\n\n### Development Setup\n```bash\ngit clone https://github.com/your-username/termivls\ncd termivls\nuv sync\nsource .venv/bin/activate\ntermivls setup --api-key YOUR_KEY\n```\n\n## \ud83d\udcca System Requirements\n\n- **Python**: 3.10 or higher\n- **OS**: macOS, Linux, Windows (WSL)\n- **Claude Code**: Latest version\n- **API Key**: InternVL API access\n\n## \ud83d\udee0\ufe0f How It Works\n\n1. **Image Processing**: Handles PNG, JPG, WEBP, GIF, BMP from files, URLs, or clipboard\n2. **Smart Analysis**: Uses InternVL AI to understand images in development context\n3. **MCP Integration**: Registers as a standard MCP server in Claude Code\n4. **Natural Interface**: No technical commands - just describe what you need\n\n## \ud83d\udd0d Troubleshooting\n\n### Quick Health Check\n```bash\ntermivls status\n```\n\n### Common Issues\n\n**\"Command not found\"**\n```bash\n# Restart terminal or:\nsource ~/.bashrc # Linux/macOS\n# Or add to PATH: ~/.local/bin\n```\n\n**\"API key invalid\"**\n```bash\n# Re-setup with correct key:\ntermivls setup --api-key YOUR_CORRECT_KEY --force\n```\n\n**\"Server not responding\"**\n```bash\n# Check logs and restart:\ntermivls run\n```\n\n### Getting Help\n- **Status Check**: `termivls status`\n- **Logs**: `termivls run` (shows real-time logs)\n- **GitHub Issues**: [Report bugs](https://github.com/your-username/termivls/issues)\n\n## \ud83c\udfa8 Use Cases\n\n### \ud83d\udc1b Debug Errors\n```\n\"This Python error is confusing, what's the actual problem?\"\n[attach error screenshot]\n```\n\n### \ud83c\udfa8 Review UI/Design\n```\n\"What's wrong with this interface from a UX perspective?\"\n[attach UI mockup]\n```\n\n### \ud83d\udcbb Analyze Code\n```\n\"Can you explain this algorithm and suggest improvements?\"\n[attach code screenshot]\n```\n\n### \ud83d\udd04 Compare Versions\n```\n\"What changed between these two versions?\"\n[attach before/after images]\n```\n\n## \ud83d\udea2 Deployment Options\n\n### Personal Use\n```bash\npipx install termivls\ntermivls setup --api-key YOUR_KEY\n```\n\n### Team/Organization\n```bash\n# Docker Compose\ncurl -O https://raw.githubusercontent.com/your-username/termivls/main/docker-compose.yml\nINTERNVL_API_KEY=your_key docker-compose up -d\n```\n\n### CI/CD Integration\n```yaml\n- name: Install TermiVis\n run: pipx install termivls\n- name: Setup TermiVis\n run: termivls setup --api-key ${{ secrets.INTERNVL_API_KEY }}\n```\n\n## \ud83e\udd1d Contributing\n\nWe welcome contributions! See [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines.\n\n```bash\n# Setup development environment\ngit clone https://github.com/your-username/termivls\ncd termivls\nuv sync\nsource .venv/bin/activate\n\n# Run tests\npytest tests/\npython examples/test_basic_functionality.py\n\n# Submit PR\n```\n\n## \ud83d\udcc4 License\n\nMIT License - see [LICENSE](LICENSE) for details.\n\n## \ud83d\ude4f Acknowledgments\n\n- **InternVL Team** - For the powerful vision-language model\n- **Anthropic** - For Claude Code and MCP protocol\n- **Python Community** - For the amazing ecosystem\n\n---\n\n**Made with \u2764\ufe0f for developers who love efficient workflows**\n\n[\ud83c\udf1f Star us on GitHub](https://github.com/your-username/termivls) \u2022 [\ud83d\udcda Documentation](https://github.com/your-username/termivls/wiki) \u2022 [\ud83d\udc1b Report Issues](https://github.com/your-username/termivls/issues)",
"bugtrack_url": null,
"license": "MIT",
"summary": "TermiVis: Visual intelligence for your terminal - MCP server for image analysis",
"version": "1.0.5",
"project_urls": {
"Bug Reports": "https://github.com/zhangbeibei/image-mcp-server/issues",
"Homepage": "https://github.com/zhangbeibei/image-mcp-server",
"Source": "https://github.com/zhangbeibei/image-mcp-server"
},
"split_keywords": [
"ai",
" claude-code",
" image-analysis",
" mcp",
" terminal",
" visual-intelligence"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "b4a3d2b1bf81fac43fe701eea3f785654b341b74024d77a8e02f95ce7e4a0053",
"md5": "054fd17f0d81da8457aa0277a66e0cd5",
"sha256": "08e65694a53f60967238815c462aec238791015fb9b0d6d31edc0dd6d0b61b67"
},
"downloads": -1,
"filename": "termivls-1.0.5-py3-none-any.whl",
"has_sig": false,
"md5_digest": "054fd17f0d81da8457aa0277a66e0cd5",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.10",
"size": 15165,
"upload_time": "2025-07-23T11:31:22",
"upload_time_iso_8601": "2025-07-23T11:31:22.732794Z",
"url": "https://files.pythonhosted.org/packages/b4/a3/d2b1bf81fac43fe701eea3f785654b341b74024d77a8e02f95ce7e4a0053/termivls-1.0.5-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "4c898cf6d58cb02d90a2a6fb37ea32286675c214fe7fe7062b72a5d60be9d318",
"md5": "925c3528965c8e90419ed1c7b6f02bd0",
"sha256": "676bd6c67a09915005c4db2e66a6ccafdb325f02ed42113b007297d9a5dda77f"
},
"downloads": -1,
"filename": "termivls-1.0.5.tar.gz",
"has_sig": false,
"md5_digest": "925c3528965c8e90419ed1c7b6f02bd0",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.10",
"size": 1075163,
"upload_time": "2025-07-23T11:31:23",
"upload_time_iso_8601": "2025-07-23T11:31:23.876984Z",
"url": "https://files.pythonhosted.org/packages/4c/89/8cf6d58cb02d90a2a6fb37ea32286675c214fe7fe7062b72a5d60be9d318/termivls-1.0.5.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-07-23 11:31:23",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "zhangbeibei",
"github_project": "image-mcp-server",
"github_not_found": true,
"lcname": "termivls"
}
JSON
