jupyter-pieces
v1.9.0
Published
Jupyterlab code snippet management tool powered by AI.
Downloads
20
Maintainers
Readme
Pieces for Developers | JupyterLab Extension
In 2022, our team embarked on a mission to transform the way you code with your personal micro-repo.
With the debut release of our Flagship Desktop App, we laid the foundation, and now our JupyterLab extension is here to revolutionize your coding workflow further by incorporating key capabilities and our users' favorite features directly into their JupyterLab environment.
Elevate your coding & problem-solving in JupyterLab with the Pieces Copilot. Interact with the Copilot from any code workspace right within your JupyterLab interface. Ask questions about code or content within a file, gain insight on keywords or patterns within code snippets, ask the Copilot to generate a sample using an SDK you’re researching, and even use it to help you understand PRs.
As you move through your workflow, our JupyterLab extension enables you to effortlessly capture, manage, share, and discover code snippets & other developer materials, such as code screenshots, with a simple click.
The Pieces for Developers JupyterLab extension is designed to become your go-to development partner, transforming your workflow with efficiency and organization.
Table of Contents
Recent Updates
v1.6.1 - Improved Pieces Copilot Experience
Oct. 3, 2023
- Introduction of Quick Actions for easy selection of LLM runtime and file context in Copilot conversations.
- Theme Matching feature to align Copilot's appearance with the environment's theme.
- Styling updates including new icons for an enhanced user experience.
v1.4.0 - Filter your Snippet List
Sept. 8, 2023
- Ability to filter snippet lists based on tags, titles, language, and more.
- Access to filtering options via a filter button and a user-friendly interface for setting up filters.
- Improved search functionality with the search bar now properly accepting user input.
v1.1.1 - Introducing Pieces Copilot
Jul. 21, 2023
- Launch of qGPT RAG Copilot, a chatbot contextualized by the code within a user's notebook(s), facilitating plain text queries.
- Incorporation of live data synchronization to ensure real-time update of modifications made in your Pieces repository via other integrations.
- New Context Menu Enrich Button to allow automatic generation of comments explaining the selected code, aimed at enhancing JupyterLab workflow.
Getting Started
Requirements
- JupyterLab >= 4.0.0
- You must have Pieces OS installed.
Pieces OS facilitates the local operation of Pieces products on your machine and coordinates connections to Pieces extensions. The extension will not function as intended without Pieces OS active on your machine.
*Pieces OS installation comes with the Pieces for Developers Desktop App where your snippets can also be viewed and managed.
Install Instructions
Execute pip install jupyter-pieces
in your terminal.
or
Search for jupyter-pieces
within the JupyterLab Extensions Manager and install.
Features
Meet Your New Copilot
Your personal copilot, powered by local or cloud-based LLMs (i.e. Llama 2, GPT-3.5, GPT-4, and PaLM 2) for maximum security and privacy, that’s contextualized by your workflow to help solve coding problems, onboard into new projects faster, and connect you with the right people.
Save Valuable Code
Templates, commands, useful snippets, notes... quickly save aspects of your code for future reference or reuse.
How to save
- Highlight code, right-click, and select "Save to Pieces."
- Click the Pieces Save button within any code block.
Find and Reuse Code Snippets
Fast, robust search of your code snippets right within JupyterLab.
Share Code from JupyterLab
Share snippets with a simple right-click, complete with relevant context - tags, descriptions, origin, and more!
Keyboard Shortcuts
To use a Pieces command, simply highlight code in your editor or hover a snippet in your Pieces List.
| Command | macOS | Windows | |--------------------------------------|------------------|------------------| | Save Selection to Pieces | Cmd+Shift+S | Ctrl+Shift+S | | Share Selection via Pieces | Cmd+Shift+K | Ctrl+Shift+K | | Save Cell to Pieces | Cmd+Shift+Enter | Ctrl+Shift+Enter | | Share Cell via Pieces | Cmd+Shift+X | Ctrl+Shift+X | | Discover Snippets | Cmd+Shift+A | Ctrl+Shift+A | | Refresh Snippets | Cmd+Shift+E | Ctrl+Shift+E | | Quick Search | Cmd+Shift+M | Ctrl+Shift+M | | Toggle View | Cmd+Shift+Y | Ctrl+Shift+Y |
Explore the Pieces Ecosystem
Maximize productivity with our Flagship Desktop App and other products designed to streamline your coding workflow across different platforms.
For detailed descriptions and features of each product, visit our docs for JupyterLab.
Need Help?
Encountered a hurdle? We've got you covered. Reach out for support:
Stay Connected
Stay in the loop! Follow us for the latest updates, tips, and insights: