https://github.com/gnana997/ollama-copilot
AI Inline Suggestion and Chat feature powered by Ollama Local LLMs
https://github.com/gnana997/ollama-copilot
javascript ollama typescript vscode vscode-extension webpack
Last synced: 2 months ago
JSON representation
AI Inline Suggestion and Chat feature powered by Ollama Local LLMs
- Host: GitHub
- URL: https://github.com/gnana997/ollama-copilot
- Owner: gnana997
- License: mit
- Created: 2025-02-28T18:28:38.000Z (over 1 year ago)
- Default Branch: master
- Last Pushed: 2025-09-15T20:13:57.000Z (9 months ago)
- Last Synced: 2025-09-15T22:21:47.189Z (9 months ago)
- Topics: javascript, ollama, typescript, vscode, vscode-extension, webpack
- Language: TypeScript
- Homepage: https://marketplace.visualstudio.com/items?itemName=Gnana997.ollama-dev-companion
- Size: 44.4 MB
- Stars: 13
- Watchers: 1
- Forks: 2
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- License: LICENSE.md
- Security: SECURITY.md
Awesome Lists containing this project
README
# Ollama Copilot
Ollama Copilot integrates local LLMs from [Ollama](https://ollama.ai/) directly into VS Code, providing AI-powered code completion and an interactive chat experience with your own locally-running models.
## What's New in v0.2.2
- Unified configuration handling so every `ollama.*` setting updates live in services, exports, and the UI.
## What's New in v0.2.1
- Ollama API host now updates live when changed via command or VS Code settings UI—no reload needed.
## What's New in v0.2.0 🎉
### Major Architecture Overhaul
- **Enterprise-grade Dependency Injection**: Complete rewrite with DI container for better modularity
- **Enhanced Security**: Comprehensive input validation, path security, and XSS prevention
- **Performance Monitoring**: Built-in metrics and resource management
- **Improved Reliability**: Automatic error recovery and retry mechanisms
### Chat Experience Improvements
- **Thinking Indicator**: Collapsible dropdown showing AI processing (like Cursor IDE)
- **Stop Generation**: Ability to stop responses mid-stream
### 🚀 Coming Soon
- **MCP Server Support**: Native Model Context Protocol integration
- **Smart Repository Indexing**: Automatic codebase analysis for better suggestions
- **Enhanced Context Awareness**: Improved understanding of your project structure
[See full changelog](CHANGELOG.md)
## Features
### AI-Powered Code Completions
Get contextual code suggestions as you type, powered by your local Ollama models:
- Smart context awareness (up to 1000 lines of surrounding code)
- Multi-line code suggestions
- Language-specific completions
- Variable and function name awareness
- Tab completion support
### Interactive Chat Interface
Engage with your code through:
- Dedicated sidebar chat panel
- Real-time streaming responses
- Context-aware code discussions
- File and workspace context integration
### Privacy-Focused
- All processing happens locally through Ollama
- No data sent to external servers
- Complete control over your models and data
### Customizable Configuration
- Choose from any installed Ollama model
- Configure API host settings
- Adjust workspace context settings
## Prerequisites
1. Install [Ollama](https://ollama.ai/) on your system
2. Pull at least one model in Ollama (see [model recommendations](#model-recommendations))
3. Make sure Ollama is running (`ollama serve`)
## Quick Start
1. Install the extension from VS Code marketplace
2. Run Ollama in the background (`ollama serve`)
3. Select a default model when prompted
4. Start coding to see inline suggestions
5. Use the sidebar chat for more complex queries
## Model Selection
Choose your model through:
1. Command Palette (`Ctrl+Shift+P` or `Cmd+Shift+P`)
2. Type "Ollama Copilot: Select Default Model"
3. Pick from your installed models
## Recommended Models
For the best experience, we recommend:
### Code Completion
- `qwen:14b` - Excellent for general code completion
- `codellama:13b` - Strong at understanding context
- `deepseek-coder:6.7b` - Fast and efficient
- `phind-codellama:34b` - Great for complex completions
### Chat Interface
- `mixtral:8x7b` - Strong reasoning and explanation
- `llama2:13b` - Good balance of speed and capability
- `neural-chat:7b` - Fast responses for simple queries
## Installing Models
```bash
# Qwen - Powerful 14B model with strong coding capabilities
ollama pull qwen:14b
# CodeLlama - Meta's specialized coding model
ollama pull codellama:13b
# Mixtral - High-performance 8x7B model
ollama pull mixtral:8x7b
# List all installed models
ollama list
```
## Usage Tips
### Code Completion
- Type normally and wait for suggestions
- Press Tab to accept full suggestions
- Use → (right arrow) to accept word by word
- Clear completion cache if suggestions seem stale
### Chat Interface
- Click the Ollama icon in the sidebar
- Use @ to reference files
- Select code before asking questions
- Toggle workspace context for broader awareness
## Commands
Access via Command Palette (`Ctrl+Shift+P` or `Cmd+Shift+P`):
- `Ollama Copilot: Select Default Model` - Change your model
- `Ollama Copilot: Clear Completion Cache` - Reset suggestions
- `Ollama Copilot: Open Chat Panel` - Open chat interface
- `Ollama Copilot: Search Available Models` - View installed models
## Configuration
Settings available in VS Code:
- `ollama.defaultModel`: Your preferred model
- `ollama.apiHost`: Ollama API endpoint (default: http://localhost:11434)
## Troubleshooting
### No Suggestions
1. Verify Ollama is running (`ollama serve`)
2. Check model is selected (Command Palette > Select Default Model)
3. Clear completion cache
4. Ensure cursor is at a valid completion point
### Performance Issues
1. Try a smaller model
2. Clear completion cache
3. Check system resources
4. Reduce context size if needed
### Connection Issues
1. Confirm Ollama is running
2. Check `ollama.apiHost` setting
3. Verify port 11434 is accessible
4. Restart VS Code if needed
## Support the Project ⭐
If you find Ollama Copilot helpful, please consider supporting the project:
### VS Code Marketplace
- **Leave a review** on the [VS Code Marketplace](https://marketplace.visualstudio.com/items?itemName=ollama-copilot) - your feedback helps other developers discover the extension
- **Rate the extension** to help improve its visibility
### GitHub
- **Star the repository** on [GitHub](https://github.com/gnana997/ollama-copilot) - it helps us understand the project's impact
- **Share with colleagues** who might benefit from local AI-powered coding assistance
Your feedback and support help us prioritize features and improvements. Every review and star makes a difference! 🙏
## Contributing
We welcome contributions! Please check our [GitHub repository](https://github.com/gnana997/ollama-copilot) for:
- Bug reports
- Feature requests
- Pull requests
- Documentation improvements
## License
[MIT License](LICENSE)