OktoScript VS Code Extension

Official VS Code extension for the OktoScript language - A declarative DSL (Domain-Specific Language) designed specifically for AI model training, fine-tuning, and deployment.

Note: This extension is free to use. OktoScript is available for personal and commercial use at no cost. However, OktoScript is a proprietary language owned by OktoSeek AI and may not be modified or used to create derivative languages, tools or interpreters.

What is OktoScript?

OktoScript is a powerful, declarative language that simplifies AI model development. Instead of writing complex Python scripts with hundreds of lines of configuration, you define your entire training pipeline in a clean, readable format. Perfect for:

• Training AI models (LLMs, vision models, etc.)
• Fine-tuning with LoRA (Low-Rank Adaptation)
• Configuring training parameters (epochs, batch size, learning rate, optimizers)
• Defining control logic (early stopping, learning rate scheduling, conditional training)
• Deploying models (export to multiple formats: OKM, SafeTensors, ONNX, GGUF)
• Safety and monitoring (guards, behavior control, system monitoring)

Features

• ✨ Syntax Highlighting - Beautiful color-coded OktoScript syntax
• 📝 Snippets - Quick code templates for all OktoScript blocks (PROJECT, MODEL, TRAIN, CONTROL, INFERENCE, etc.)
• 🔍 Autocomplete - Smart suggestions based on OktoScript keywords
• ✅ Validation - Validate your .okt files using OktoEngine (requires OktoEngine installation)
• 🌐 Web Editor Integration - Open files directly in the OktoScript Web Editor

Requirements

• VS Code 1.74.0 or higher
• OktoEngine (optional, for validation and web editor features)
  • Download from: GitHub Releases
  • Must be in your system PATH, or configure the path in settings

Installation

Install from VS Code Marketplace (Recommended)

1. Open VS Code
2. Press Ctrl+Shift+X (or Cmd+Shift+X on Mac) to open Extensions
3. Search for "OktoScript"
4. Click "Install"

Or use the command line:

code --install-extension OktoSeekAI.oktoscript

Install from VSIX (Alternative)

If you have a .vsix file:

code --install-extension oktoscript-1.0.0.vsix

Marketplace Link: Install OktoScript from VS Code Marketplace

Usage

Syntax Highlighting

Open any .okt file and enjoy syntax highlighting for:

• Blocks (PROJECT, MODEL, TRAIN, CONTROL, etc.)
• Keywords (IF, WHEN, SET, LOG, etc.)
• Strings, numbers, comments
• Field names and enum values

Snippets

Type block names and press Tab to insert templates:

• PROJECT → PROJECT block
• MODEL → MODEL block
• TRAIN → TRAIN block
• CONTROL → CONTROL block with IF/WHEN examples
• INFERENCE → INFERENCE block
• FT_LORA → LoRA fine-tuning block
• And many more...

Validation

1. Open a .okt file
2. Press Ctrl+Shift+P (or Cmd+Shift+P on Mac)
3. Type "OktoScript: Validate current file"
4. Or use the command palette

Note: Validation requires OktoEngine to be installed. If not found, you'll see a message with a link to download it.

Web Editor

1. Open a .okt file
2. Press Ctrl+Shift+P (or Cmd+Shift+P on Mac)
3. Type "OktoScript: Open in Web Editor"
4. The file will open in your browser with the OktoScript Web Editor

Note: Web editor integration requires OktoEngine to be installed.

Configuration

OktoEngine Path

If OktoEngine is not in your PATH, configure it in VS Code settings:

1. Open Settings (Ctrl+, or Cmd+,)
2. Search for "OktoScript"
3. Set OktoScript: Engine Path to your OktoEngine executable path

Example:

{
  "oktoscript.enginePath": "C:\\Users\\YourName\\oktoengine\\okto.exe"
}

Show Engine Warning

Control whether to show warnings when OktoEngine is not found:

{
  "oktoscript.showEngineWarning": true
}

Commands

• OktoScript: Validate current file - Validate the current .okt file
• OktoScript: Open in Web Editor - Open current file in web editor

Language Support

This extension provides language support for OktoScript v1.0, v1.1, and v1.2, including:

• All core blocks (PROJECT, DATASET, MODEL, TRAIN, EXPORT)
• Advanced blocks (CONTROL, MONITOR, GUARD, BEHAVIOR, EXPLORER, STABILITY, SECURITY, DEPLOY, INFERENCE)
• LoRA fine-tuning (FT_LORA)
• Dataset mixing and custom fields
• All field names, enum values, and keywords

Resources

• OktoScript Documentation: Grammar Specification
• OktoEngine: GitHub Repository
• Web Editor: https://oktoseek.com/editor.php
• Official Website: https://www.oktoseek.com

Contributing

Contributions are welcome! Please open an issue or submit a pull request on GitHub.

License

This extension is free to use.

OktoScript is available for personal and commercial use at no cost.

However, OktoScript is a proprietary language owned by OktoSeek AI and may not be modified or used to create derivative languages, tools or interpreters.

See OKTOSCRIPT_LICENSE.md for complete license terms.

Support

• Issues: GitHub Issues
• Documentation: OktoScript Docs
• Community: OktoSeek Community

Made with ❤️ by OktoSeek AI