Quickstart

This page walks you through the full first-time setup: install the package, copy the template folder to your machine, configure your LLM provider, and verify everything works before your first hunt.

Requirements

Before installing dAIana, make sure you have:

  • Python 3.10 or higher.

  • pdflatex and the moderncv package on your $PATH.

  • An API key from Perplexity (sonar / sonar-pro / sonar-max) or OpenAI (gpt-4o-mini / gpt-4o).

# macOS (MacTeX)
brew install --cask mactex

# Ubuntu / Debian
sudo apt install texlive-full

Installation

pip install daiana

Step 1 — Copy the template folder

Run this command from inside the cloned or installed dAIana directory. It copies the job_hunt/ folder — which contains your LaTeX templates, prompt files, and tracking folders — to any location you choose.

daiana init --copy_dir

You will be prompted for a destination path. If you press Enter, it defaults to your home directory. The result will be a job_hunt/ folder at that location, with this structure:

job_hunt/
├── cv_and_letter/
│   ├── template_cv.tex      ← your CV template
│   ├── template_cl.tex      ← your cover letter template
│   └── loader/              ← modular LaTeX \newcommand files
├── prompts/                 ← AI prompt files (Markdown)
│   ├── background/
│   ├── career/
│   ├── job/
│   ├── projects/
│   └── sentence/
├── job_tracking/            ← CSV files are saved here
└── pdf_output/              ← compiled PDFs land here

Note

All dAIana commands must be run from inside this job_hunt/ folder. This will be the main location where you will operate to create your tailored cover letter and CV, as well as your tracking job lists.

Step 2 — Configure your provider

This command will set things up so that you can use your AI services through your terminal. This command will guide you to create a .env file where you will write down your API provider and its associated SECRET KEY. Navigate into the previously copied folder and run:

cd path/to/job_hunt
daiana init --set_env

You will be prompted for:

Prompt

What to enter

Provider

perplexity or openai.

Model

For example sonar, sonar-pro, or gpt-4o-mini.

Base URL

Pre-filled automatically for known providers.

API key name

For example PERPLEXITY_API_KEY.

API key value

Your actual secret key. The input is hidden.

All values are written to the previoulsy mentioned .env file in the current directory and will loaded automatically on every subsequent command.

Tip

If you already have an environment file, double-check that the provider, model, and API key name match the values expected by your account.

Step 3 — Verify your setup

Now that we have set up our API provider and location of operations, it is time to check that the API works fine. Before your first hunt, run:

daiana check --env --prompts

  • --env prints the loaded environment variables and confirms the LLM client can be built with your credentials.

  • --prompts loads every prompt file from job_hunt/prompts/ and confirms they are readable and non-empty.

If either check fails, fix the reported issue before continuing.

Warning

Do not skip this step. If the environment or prompt files are misconfigured, the later commands may fail in confusing ways.

Next steps

Once daiana check passes, you are ready to go.