Skip to content

Commit

Permalink
Merge pull request #26 from chloedia/feat/structured_generation
Browse files Browse the repository at this point in the history
feat: add structured generation
  • Loading branch information
chloedia authored Jan 21, 2025
2 parents 3a15fd8 + c78f73f commit 6bfb2e3
Show file tree
Hide file tree
Showing 8 changed files with 484 additions and 360 deletions.
14 changes: 10 additions & 4 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,7 +1,13 @@
# Obsidian Local FlashCard Generator
<p align="center">
<img src="images/logo.png" alt="QuizCraft Logo" width="300"/>
</p>

<h1 align="center">Obsidian FlashCard Generator</h1>

<p align="center">
🚀 <strong>Supercharge your Obsidian workflow</strong>, the revolutionary Obsidian plugin designed to <strong>transform your notes into dynamic flashcards</strong>. Seamlessly harness the power of LLMs, such as GPT-4o, or any OSS LLM to effortlessly generate customized flashcards from your notes. Prepare for exams, retain crucial information, and enhance your learning experience like never before.
</p>

🚀 **Supercharge your Obsidian workflow with QuizCraft**, the revolutionary Obsidian plugin designed to **transform your notes into dynamic flashcards**. Seamlessly harness the power of LLMs, such as GPT-3 or GPT-4, or any OSS LLM to effortlessly generate customized flashcards from your notes. Prepare for exams, retain crucial information, and enhance your learning experience like never before.

## Features

Expand All @@ -14,14 +20,14 @@
2. ⚙️ Access the plugin settings in Obsidian by navigating to `Settings` > `Flashcard Generator` under `Community Plugins`.
3. ✅ Untoggle the "Use Local LLM" option if you want OpenAI.
4. 🛠️ Enter your OpenAI API key in the designated field.
5. 💻 Choose which model (gpt3.5 or gpt4) you want to use.
5. 💻 Choose which model (gpt-4o or gpt-4o-mini) you want to use.
6. 🔢 Choose whether to limit the number of questions to 10.

### Local LLM
1. 🛠️ Install Ollama from [here](https://ollama.com/) and follow the instructions to install it locally.
2. ⚙️ Access the plugin settings in Obsidian by navigating to `Settings` > `Flashcard Generator` under `Community Plugins`.
3. ✅ Toggle the "Use Local LLM" option if you want to use local models instead of OpenAI.
4. 💻 Choose which model from ollama you want to use (you need to run a Model from Ollama first).
4. 💻 Choose which model from ollama you want to use (you need to pull the Model from Ollama first) - We recommend using llama3, knoopx/hermes-2-pro-mistral, or models certified being able to generate structured output.

⚠ You might have a CORS issue, to fix it, go in you terminal and run ```export OLLAMA_ORIGINS="app://obsidian.md*"```(mac/linux) or ```SETX /M OLLAMA_ORIGINS "app://obsidian.md*```on Windows

Expand Down
Binary file added images/logo.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
2 changes: 1 addition & 1 deletion manifest.json
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
{
"id": "flashcard-gen",
"name": "Flashcard Generator",
"version": "1.0.1",
"version": "1.0.2",
"minAppVersion": "0.15.0",
"description": "Craft insightful quizzes: Generate key questions/answers pairs from your notes effortlessly using Open ai's GPT-3/4 or local models. Elevate and optimize your learning journey.",
"author": "ChloeDia (improved by lulmer)",
Expand Down
Loading

0 comments on commit 6bfb2e3

Please sign in to comment.