{"id":31384066,"url":"https://github.com/datalayer/vscode-datalayer","last_synced_at":"2026-02-06T06:13:43.978Z","repository":{"id":316649847,"uuid":"1063359848","full_name":"datalayer/vscode-datalayer","owner":"datalayer","description":"👨‍💻 ☰ VS Code extension for Datalayer.","archived":false,"fork":false,"pushed_at":"2026-02-04T04:40:03.000Z","size":3816,"stargazers_count":4,"open_issues_count":40,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-02-04T14:23:34.037Z","etag":null,"topics":["ai","data","gpu","jupyter","runtimes","vscode","vscode-extension"],"latest_commit_sha":null,"homepage":"https://marketplace.visualstudio.com/items?itemName=Datalayer.datalayer-jupyter-vscode","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/datalayer.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE.txt","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"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},"funding":{"github":["datalayer"]}},"created_at":"2025-09-24T14:14:26.000Z","updated_at":"2026-02-03T05:28:58.000Z","dependencies_parsed_at":null,"dependency_job_id":"807780d9-7868-4ac1-ba33-9affb3f70a27","html_url":"https://github.com/datalayer/vscode-datalayer","commit_stats":null,"previous_names":["datalayer/vscode-datalayer"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/datalayer/vscode-datalayer","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/datalayer%2Fvscode-datalayer","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/datalayer%2Fvscode-datalayer/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/datalayer%2Fvscode-datalayer/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/datalayer%2Fvscode-datalayer/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/datalayer","download_url":"https://codeload.github.com/datalayer/vscode-datalayer/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/datalayer%2Fvscode-datalayer/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29153368,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-06T02:39:25.012Z","status":"ssl_error","status_checked_at":"2026-02-06T02:37:22.784Z","response_time":59,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"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","data","gpu","jupyter","runtimes","vscode","vscode-extension"],"created_at":"2025-09-28T14:14:30.069Z","updated_at":"2026-02-06T06:13:43.972Z","avatar_url":"https://github.com/datalayer.png","language":"TypeScript","funding_links":["https://github.com/sponsors/datalayer"],"categories":[],"sub_categories":[],"readme":"\u003ca href=\"https://datalayer.io\"\u003e\u003cimg src=\"https://assets.datalayer.tech/datalayer-25.png\" width=\"150\"/\u003e\u003c/a\u003e\n\n[![Become a Sponsor](https://img.shields.io/static/v1?label=Become%20a%20Sponsor\u0026message=%E2%9D%A4\u0026logo=GitHub\u0026style=flat\u0026color=1ABC9C)](https://github.com/sponsors/datalayer)\n\n[![Build Status](https://github.com/datalayer/vscode-datalayer/actions/workflows/build-extension.yml/badge.svg)](https://github.com/datalayer/vscode-datalayer/actions/workflows/build-extension.yml)\n[![VS Code Marketplace](https://img.shields.io/visual-studio-marketplace/v/Datalayer.datalayer-jupyter-vscode?label=VS%20Code%20Marketplace\u0026logo=visual-studio-code)](https://marketplace.visualstudio.com/items?itemName=Datalayer.datalayer-jupyter-vscode)\n[![Installs](https://img.shields.io/visual-studio-marketplace/i/Datalayer.datalayer-jupyter-vscode?label=Installs)](https://marketplace.visualstudio.com/items?itemName=Datalayer.datalayer-jupyter-vscode)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n[![Documentation](https://img.shields.io/badge/docs-TypeDoc-blue.svg)](https://vscode-datalayer.netlify.app)\n\n# Datalayer for Visual Studio Code\n\n**🚀 Transform VS Code into a collaborative data science platform with seamless local-to-cloud scaling and rich document creation in just 2 clicks.**\n\n💻 Execute notebooks on cloud compute, 📝 create beautiful reports with Notion-like collaborative documents, and 🔄 switch effortlessly between local and remote environments - all within your familiar VS Code interface.\n\n**See it in action:**\n\n\u003cimg src=\"https://assets.datalayer.tech/demo-vscode-lexical.gif\" alt=\"Datalayer extension running Datalayer document in VS Code\"/\u003e\n\n## 🚀 Key Benefits\n\n### ⚡ **Instant Cloud Scaling**\n\n- **Zero-setup cloud execution** - Run workloads on cloud CPUs or GPUs without any local Python installation\n- **2-click scaling** - Switch from local development to cloud compute instantly via the kernel picker\n- **Smart resource management** - Automatic runtime creation and reuse to optimize compute costs\n\n### 📝 **Collaborative Rich Documents**\n\n- **Notion-like documents** with rich formatting - Create beautiful reports with headings, lists, images, tables, executable code blocks, etc.\n- **Real-time collaboration** - Multiple users can edit documents simultaneously with live updates\n- **Mixed content support** - Seamlessly combine executable code, images, text, and more in a single document\n\n### 🔀 **Ultimate Flexibility**\n\n- **Seamless local ↔ cloud switching** - Start locally, scale to cloud, then return to local development\n- **Multiple runtime support** - Connect to Datalayer cloud, local Python, or existing Jupyter servers\n- **Code preservation** - Your code runs identically across local and cloud environments\n- **Hybrid workflows** - Use the best of both worlds without vendor lock-in\n\n## ⚡ Quick Start\n\n1. **Create a free account** at [datalayer.app](https://datalayer.app).\n2. **Install** from [VS Code Marketplace](https://marketplace.visualstudio.com/items?itemName=Datalayer.datalayer-jupyter-vscode)\n3. **Login**: `Ctrl+Shift+P` → \"Datalayer: Login to Datalayer\" → select your type of OAuth login (GitHub)\n4. **Scale instantly**: Open any `.ipynb` file with the Datalayer Editor → click kernel picker → select cloud runtime\n5. **Create rich docs**: Create `.dlex` files for Notion-like collaborative reports with code, images and rich formatting\n\n## 🎯 Core Features\n\n### 📊 **Advanced Document Editors**\n\n#### Jupyter Notebooks\n\n- Full-featured notebook editing with syntax highlighting and IntelliSense\n- Execute on cloud GPUs/CPUs, local Python kernels, or remote Jupyter servers\n- Seamless kernel switching between cloud, local, and remote runtimes\n- Native ZMQ integration for local Python execution (no Jupyter server required)\n\n#### Datalayer Documents\n\n- Notion-like rich text editor with real-time collaborative editing\n- Support for images, tables, code blocks, mathematical equations, and formatted text\n- Perfect for creating data science reports, documentation, and presentations\n\n### 🗂️ **Integrated Workspace Management**\n\n**Datalayer Spaces** (Explorer Sidebar)\n\n- Browse and manage your cloud documents and notebooks\n- Create, rename, delete files directly in the cloud\n- Virtual file paths: `datalayer://Space Name/document.ipynb`\n- Access to shared workspaces\n\n**Datalayer Runtimes** (Explorer Sidebar)\n\n- Real-time monitoring of all active cloud environments\n- One-click runtime creation and termination\n- Environment type indicators (CPU/GPU, memory, duration)\n- Health status monitoring\n\n**Datalayer Settings** (Explorer Sidebar)\n\n- **Datasources** - Manage connections to external data sources (Athena, BigQuery, MS Sentinel, Splunk)\n  - Create and configure datasources with database and output bucket settings\n  - Click to edit datasource properties\n  - Quick access via right-click context menu\n  - Type indicator shows datasource variant (athena, bigquery, mssentinel, splunk)\n- **Secrets** - Secure credential management for datasource authentication\n\n### ⚙️ **Smart Runtime Management**\n\n- **Auto-connect** - Documents automatically connect to available runtimes (configurable)\n- **On-demand creation** - Create runtimes through the kernel picker when needed\n- **Intelligent reuse** - Existing healthy runtimes are reused to conserve credits\n- **Health verification** - Automatic checks ensure runtime reliability\n- **Flexible duration** - Configure runtime lifetime (1-1440 minutes)\n\n### 🎨 **Native VS Code Integration**\n\n- **Theme synchronization** - Documents automatically match your VS Code theme\n- **Unified kernel picker** - Access Datalayer cloud runtimes, local Python environments (via Python extension), and existing Jupyter servers\n- **Native local execution** - Direct ZMQ kernel communication without Jupyter server\n- **Rich status indicators** - Connection status and runtime info in status bar\n- **Command palette integration** - All features accessible via `Ctrl+Shift+P`\n- **GitHub Copilot integration** - Use natural language to create notebooks and insert cells (e.g., \"Create a local notebook and add a plot\")\n\n## 💡 Common Questions\n\n**Do I need Python locally?** No! Cloud runtimes handle all execution with zero local setup. You can still connect to local Python/Jupyter environments if preferred for hybrid workflows.\n\n**Can I edit cloud documents?** Yes! Cloud documents are fully editable. Create, modify, and collaborate on notebooks and Datalayer documents directly in your cloud spaces.\n\n**How do credits work?** Runtimes consume credits while active. The extension intelligently reuses existing healthy runtimes to minimize costs and maximize your credit efficiency.\n\n**Can I use without a Datalayer account?** Absolutely! Use it for local `.ipynb` files and connecting to your existing Python/Jupyter environments. Cloud features require an account.\n\n**How do I get an access token?** Visit [datalayer.app](https://datalayer.app), navigate to account settings, and generate a token for VS Code integration.\n\n**How fast is the local ↔ cloud switching?** Switching between local and cloud execution takes just 2 clicks via the kernel picker - no configuration or setup required.\n\n**What makes Datalayer Documents special?** Think Notion meets Jupyter! Unlike traditional notebooks, Datalayer Documents provide a Notion-like editing experience with rich formatting, real-time collaboration, and support for images, tables, and formatted text alongside executable code - perfect for creating professional reports and documentation.\n\n## Installation\n\n**From Marketplace:**\n\n1. Open Extensions view (`Ctrl+Shift+X` / `Cmd+Shift+X`)\n2. Search \"Datalayer Platform\"\n3. Click Install\n\n**From `.vsix` file:**\n\n1. Download from [releases](https://github.com/datalayer/vscode-datalayer/releases)\n2. Open Command Palette (`Ctrl+Shift+P` / `Cmd+Shift+P`) → \"Extensions: Install from VSIX...\"\n\n## Key Commands\n\n**Authentication:**\n\n- Login/Logout\n- Show Authentication Status\n\n**Documents:**\n\n- Create New Jupyter Notebook (local or cloud)\n- Create New Datalayer Document (local or cloud)\n- Context menu in Spaces tree: New Notebook/Datalayer Document in cloud workspace\n- Context menu: Open, Rename, Delete\n\n**Runtimes:**\n\n- Select/Switch Runtime (local ↔ cloud switching)\n- Terminate Runtime(s)\n- View Runtime Controllers Status\n- Monitor resource usage and costs\n\n## Configuration\n\nOpen settings (`Ctrl+,` / `Cmd+,`) and search \"Datalayer\":\n\n**Service URLs** - Default to `https://prod1.datalayer.run`:\n\n- `datalayer.services.iamUrl`\n- `datalayer.services.runtimesUrl`\n- `datalayer.services.spacerUrl`\n- `datalayer.services.spacerWsUrl` (WebSocket: `wss://prod1.datalayer.run`)\n\n**Runtime:**\n\n- `datalayer.runtime.defaultMinutes` - Duration (default: 10, max: 1440)\n- `datalayer.autoConnect.strategies` - Auto-connect strategies when opening documents (default: `[\"Active Runtime\", \"Ask\"]`)\n  - `[\"Active Runtime\"]` - Automatically connect to runtime with most time remaining\n  - `[\"Active Runtime\", \"Ask\"]` - Try active runtime, then ask user if none available\n  - `[\"Ask\"]` - Always show runtime selection dialog\n  - `[]` - No auto-connect, manual selection required\n\n**Logging:**\n\n- `datalayer.logging.level` - trace/debug/info/warn/error (default: info)\n- `datalayer.logging.includeTimestamps` - Add timestamps (default: true)\n- `datalayer.logging.enableSDKLogging` - Log API calls (default: true)\n- `datalayer.logging.enablePerformanceMonitoring` - Track performance (default: false)\n\n## Recent Updates\n\n### Runtime Controller Improvements\n\n- **Smart Runtime Switching**: Kernel picker now shows individual runtime controllers for seamless switching between cloud environments\n- **Automatic Kernel Selection**: Selecting a runtime automatically activates it as the notebook kernel\n- **Proper Cleanup**: Switching between runtimes properly disposes old WebSocket connections\n- **Tree View Sync**: Runtime tree automatically refreshes when runtimes are created or selected\n\n### Documentation \u0026 Quality\n\n- **TypeDoc API Documentation**: Complete API documentation now available at [vscode-datalayer.netlify.app](https://vscode-datalayer.netlify.app)\n- **Zero TypeDoc Warnings**: All exported types properly documented\n- **Node.js 22 Compatibility**: Fully updated to match VS Code 1.107.0 runtime requirements\n\n## Developer Resources\n\n- [DEVELOPMENT.md](./dev/docs/DEVELOPMENT.md) - Setup, debugging, architecture, jupyter package workflow\n- [CONTRIBUTING.md](./dev/docs/CONTRIBUTING.md) - Contribution guidelines\n- [TESTING.md](./dev/docs/TESTING.md) - Test infrastructure (41 tests, 100% pass)\n- [CHANGELOG.md](./CHANGELOG.md) - Version history\n- [API Documentation](https://vscode-datalayer.netlify.app) - Complete TypeScript API reference\n\n## Support \u0026 Community\n\n- [GitHub Issues](https://github.com/datalayer/vscode-datalayer/issues) - Bug reports and features\n- [Datalayer Docs](https://docs.datalayer.ai) - Platform documentation\n- [Website](https://datalayer.ai) - Learn more\n\n## License\n\nMIT License - See [LICENSE](./LICENSE.txt)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdatalayer%2Fvscode-datalayer","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdatalayer%2Fvscode-datalayer","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdatalayer%2Fvscode-datalayer/lists"}