Odin Runes

Welcome to Odin Runes, a powerful GPT (Generative Pre-trained Transformer) client that revolutionizes the way you interact with GPT models. With Odin Runes, you can seamlessly integrate with various GPT providers, overcoming vendor lock-in and unlocking the true potential of natural language processing. Through a simple and intuitive GUI, Odin Runes enables you to chat with your chosen GPT right through your favorite text editor. It also empowers you to capture context from various sources, such as clipboard, OCR from a region on the screen, and OCR from an entire scrollable region on the screen, providing valuable context to GPT models for more accurate and meaningful responses. This comprehensive README.md will guide you through the features, advantages, setup, usage, configuration, and resources of Odin Runes. (stay tuned for Demo video!)

Odin Runes Wiki

For a quick peek at the various use cases and capabilities of Odin Runes, feel free to explore Odin Runes Wiki. The wiki contains many short gif demos that showcase the unique features and functionality of Odin Runes. It is regularly updated with new content to keep you informed about the latest advancements and possibilities with Odin Runes.

Demo Video

Experience the power of OdinRunes in action with an engaging demo. Click the play button below to witness how this useful java tool, driven by GPTs, boosts your productivity and saves you valuable time. For more up to date and shorter demos check the wiki above, since the demo video below does not contain the latest updates and added features.

Major Updates

Integration of gpt-4o-mini (OdinRunes-1.5-SNAPSHOT July 20, 2024): OdinRunes now includes support for gpt-4o-mini, allowing users to supply images within the context for enhanced capabilities. see demo
Support for Ollama (OdinRunes-1.2-SNAPSHOT February 9, 2024): Odin Runes now includes support for Ollama, an open-source tool available at https://github.com/ollama/ollama. Ollama facilitates the local execution of multiple open-source LLMs (Language Model Models).

Features
Advantages of Using Odin Runes
Setup and Installation
Dependencies
Usage
Contributors
License
Resources

Features

Odin Runes offers a range of powerful features that enhance your interaction with GPT models:

Interact with your desired GPT right through your favorite text editor
Avoid vendor lock-in with a multi-cloud approach
Switch to the GPT provider of your choice seamlessly, including locally deployed open-source LLMs.
Capture context from various sources such as clipboard, OCR from a region on the screen, OCR from an entire scrollable region on the screen, and dynamically from a file
Save context and load it in different conversations
Save chats independently from their context for greater flexibility

Advantages of Using Odin Runes

Odin Runes offers several advantages over traditional GPT clients:

Avoid Vendor Lock-in: By embracing a multi-cloud approach, Odin Runes liberates you from vendor lock-in. You are no longer constrained to a single GPT provider, giving you the freedom to choose the provider that offers the best performance, cost-effectiveness, or features for your specific application. This flexibility ensures you can adapt to changing requirements and leverage the advancements of different GPT providers. Odin Runes currently integrates with several GPT providers, including OpenAI's gpt-3.5-turbo, as well as Google's gemini-pro, and chat-bison via GCP's VertexAI. Stay tuned for future integrations with additional GPT providers. Additionally, Odin Runes offers the flexibility to integrate your own GPT providers by implementing the WellsOfWisdom Interface. This allows you to expand the platform's capabilities and incorporate your preferred GPT provider seamlessly. For more information on how to integrate your own provider, please watch the demo provided.
Enhanced User Experience: By seamlessly integrating GPT models with your favorite text editor through Odin Runes, you can unlock a host of benefits. You'll have the power to leverage the extensive features of your trusted text editor, making your interactions with GPT models more versatile and efficient. Imagine being able to utilize powerful text editing capabilities such as syntax highlighting, code folding, and search-and-replace functionality while conversing with GPT models. This integration allows you to harness the full potential of GPT models within the familiar environment of your text editor. Moreover, because chat sessions are stored as files on your file system, you can take advantage of existing operating system features like grep to easily search and manage your past conversations with GPT models.
Improved Contextual Understanding: Odin Runes allows you to provide context to GPT models through various sources such as clipboard, OCR-based screen region capture, OCR-based scrollable region capture, and dynamically from a file. By enriching conversations with relevant information, the GPT models possess a better understanding of the context, leading to more accurate and meaningful responses. This contextual understanding enables applications like document summarization, content generation, and more.
Effortless Context and Chat Management: With Odin Runes, managing context and chats becomes seamless. You can save and load context independently, facilitating the reuse of previously saved context across multiple conversations. Furthermore, saving and loading chats independently allows for greater flexibility and control over the conversations. This effortless context and chat management streamlines your workflow and enables efficient interaction with GPT models.
Easy Integration with New Models: Odin Runes' modular design provides a solid foundation for integrating new GPT models and providers. Adding support for new models is made easier by extending the existing codebase and implementing the custom GPT interface. As the landscape of GPT models evolves, you can effortlessly integrate and experiment with emerging models without the need to rework the entire application.
Flexibility with Open-Source LLMs: Odin Runes now allows you to leverage Ollama to execute multiple open-source LLMs locally. By integrating Ollama into Odin Runes, you can take advantage of the diverse range of open-source LLMs available in the Ollama repository, expanding your options for language model models.

Installation

To install and set up Odin Runes, follow these steps:

Clone the repository to your local machine:

git clone https://github.com/leonid20000/OdinRunes.git

Navigate to the project directory:
```
cd OdinRunes
```
Build the project using Maven:
```
mvn clean install
```
Ensure that the necessary dependencies are installed and added to your project. You can find the list of dependencies in the pom.xml file. (Maven helps you with this)
Set up the required environment variables:
- GCLOUD_VERTEX_AI_ACCESS_TOKEN: Set this environment variable to the access token for the Google Cloud Vertex AI. It is needed to authenticate requests to the Vertex AI API. (Required for using Google's GPT APIs.)
- OPENAI_API_KEY_ODIN_FIRST: Set this environment variable to the API key for OpenAI. (Required for using OpenAI's GPT APIs.)
- TESSDATA_PREFIX: Set this environment variable to the path where Tesseract's tessdata folder is located. It is needed for Tesseract to locate the necessary language data for OCR.
- VERTEXAI_API_ENDPOINT: Set this environment variable to the API endpoint for Google Cloud Vertex AI. It specifies the location of the Vertex AI service for making API requests. (Required for using Google's GPT APIs.)
- VERTEXAI_PROJECT_ID: Set this environment variable to the project ID for your Google Cloud project. It is required to make API requests to the Vertex AI service. (Required for using Google's GPT APIs.)
Once the installation and setup are complete, you can run Odin Runes. You can run Odin Runes by double-clicking on the JAR file target/OdinRunes-1.5-SNAPSHOT-jar-with-dependencies.jar or alternatively by using the following command:
```
java -jar target/OdinRunes-1.5-SNAPSHOT-jar-with-dependencies.jar
```
This will start the Odin Runes application.

Congratulations! You have successfully installed and set up Odin R

OdinRunes

Install / Use

README