GermAnki

Make Anki German vocabulary card creation less time-consuming with GermAnki.

This is only possible thanks to AnkiConnect, TTSMP3, and Pexels. Thanks!

Features

1. Automatically include pronunciation audio to your card.
2. Automatically include a relevant image to your card.

ChatGPT Input Mode

If you have an OpenAI API key, Germanki will prompt ChatGPT and create all your card contents for you. Just enter the word or expressions you want to generate a card for.

Customizations

Change Speaker's Voice

Choose among available voices to pronounce the German text the front of your card.

Refresh Image

Is the first image pick not good enough? Click the Refresh Images button and get a new random one.

Requirements

1. Install the AnkiConnect add-on.
2. Add support these three fields in your Basic Anki card type: Front, Back, and Extra.

Optional:

1. Create an account on Pexels and create your API key. It's free. Then set the environment variable PEXELS_API_KEY to your key.

   Required to have images in your cards

2. Create an account on ChatGPT to generate inputs for you.

3. Generate an OpenAI API Key and add it to Germanki so that it can generate the card contents for you.

   Required to have ChatGPT Input Mode

Run

1. Clone this repository
2. Install uv

Then, inside the repository:

uv run germanki

Then go to http://localhost:8000/.

Alternatively, use Docker

Set your environment variables.

# set your Pexels API key if you have one
export PEXELS_API_KEY=<your-api-key>
# set your OpenAI API key if you have one
export OPENAI_API_KEY=<your-api-key>

On Linux:

docker run -p 8000:8000 -e OPENAI_API_KEY -e PEXELS_API_KEY --network host gabrielrphub/germanki:latest

On Mac:

docker run -p 8000:8000 -e OPENAI_API_KEY -e PEXELS_API_KEY --add-host=localhost:host-gateway gabrielrphub/germanki:latest

Then go to http://localhost:8000/.

Anki Cards

By default, this is how the GermAnki is programmed to work.

Front:

• The German word.
• A pronunciation audio.

Back:

• The English translations.
• A relevant picture to help with memorization.

Extra:

• Description, example, and other information relevant for the word type e.g. perfect form of verbs, article and plural form of nouns.

Example: