Ollama for Sublime Text

This plugin provides seamless integration between Sublime Text and Ollama, allowing you to interact with AI models directly from your editor.

Features

• 🤖 Direct integration with Ollama API
• 📝 Context-aware prompts using selected text or entire file
• 🔄 Streaming responses directly into your editor
• 📚 Template system for quick access to common prompts
• ⚡️ Keyboard shortcuts for quick access

Installation

Prerequisites

1. Install Ollama
2. Have Sublime Text 3 or 4 installed
3. Have Package Control installed in Sublime Text

Installation Steps

1. Open Command Palette (Cmd/Ctrl + Shift + P)
2. Select "Package Control: Install Package"
3. Search for "Ollama" and install

Usage

Basic Commands

Open the command window (Cmd/Ctrl + Shift + P) then type:

• Ollama: Select Model to choose an Ollama model
• Ollama: Ask Prompt to enter a prompt
• Ollama: Use Template to use a saved template
• Ollama: Add Template to save a new template
• Ollama: Remove Template to delete a template
• Ollama: Settings to configure the plugin
• Ollama: Cancel Request to cancel the current request
• Ollama: Show History to show the history
• Ollama: Clear History to clear the history
• Ollama: Toggle Output Panel to show/hide the output panel
• Ollama: Add Context to add files or folders as context
• Ollama: Remove Context to remove previously added contexts

I recommend setting up keyboard shortcuts for these commands, e.g.

{ "keys": ["shift+super+t"], "command": "ollama_use_template" },
{ "keys": ["shift+super+h"], "command": "ollama_show_history" },
{ "keys": ["super+shift+o"], "command": "ollama_ask_any", "args": { "prompt": null } },
{ "keys": ["ctrl+shift+c"], "command": "ollama_cancel_request", "args": {} },
{ "keys": ["super+shift+k"], "command": "ollama_toggle_output_panel", "args": {} },
{ "keys": ["super+shift+m"], "command": "ollama_select_model", "args": {} },
{ "keys": ["super+shift+c"], "command": "ollama_add_context", "args": {} },
{ "keys": ["super+ctrl+c"], "command": "ollama_remove_context", "args": {} }

Adding Context

• Use Ollama: Add Context to add files or folders as context
• Supports wildcards (e.g., ./src/**.py for all Python files in src and subdirectories)
• Use Ollama: Remove Context to remove previously added contexts
• Only text-based file types are included (configurable in settings)
• Context files are automatically included in all queries

Example context patterns:

• ./src/**.py - all Python files in src and subdirectories
• ./docs/*.md - all Markdown files in docs directory
• ./config.json - single file
• ./templates/ - all supported files in templates directory

Output Panel

The output panel provides a dedicated space for viewing AI responses without modifying your current file. You can:

• Toggle it with Cmd/Ctrl + Shift + K
• Use it through Command Palette: Ollama: Toggle Output Panel
• Keep it open while working with multiple prompts
• Scroll through longer responses easily

Working with Context

1. Select text in editor (optional)
2. Use any of the prompt commands
3. If text is selected, it will be used as context
4. If no text is selected, the entire file content will be used

Working with Templates

Templates allow you to save frequently used prompts for quick access.

To add a template:

1. Open Command Palette
2. Select "Ollama: Add Template"
3. Enter template title
4. Enter template prompt

To use a template:

1. Open Command Palette
2. Select "Ollama: Use Template"
3. Choose template from list
4. Edit prompt if needed
5. Press Enter to execute

Configuration

Default settings can be modified through: Preferences > Package Settings > Ollama > Settings

{
  "ollamaUrl": "http://localhost:11434",
  "systemPrompt": "You are a helpful assistant.",
  "selected_model": "",
  "templates": [
    {
      "title": "Summarize",
      "prompt": "Summarize the text.",
      "model": "phi4:latest" // model is optional
    },
    {
      "title": "Translate",
      "prompt": "Translate the following text to French."
    }
  ],
  "history": []  // Stores last 50 prompts automatically
}

Settings Description

• ollamaUrl: URL where Ollama is running
• systemPrompt: Default system prompt for all requests
• selected_model: Currently selected Ollama model
• templates: Array of saved templates
  • title: Template name shown in selection menu
  • prompt: The prompt text
  • model: (Optional) Specific model for this template
• history: Array of previous prompts (managed automatically)

Requirements

• Sublime Text 3 or 4
• Ollama installed and running
• requests Python package (installed automatically)

Troubleshooting

1. No models available

   • Ensure Ollama is running (ollama serve)
   • Check the Ollama URL in settings
   • Verify you have at least one model pulled (ollama pull modelname)

2. Connection errors

   • Check if Ollama is running
   • Verify the URL in settings
   • Check console for detailed error messages

3. Slow responses

   • Consider using a smaller/faster model
   • Check your system resources
   • Verify network connection

License

MIT License

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

1. Fork the repository
2. Create your feature branch
3. Commit your changes
4. Push to the branch
5. Create a new Pull Request