The Ultimate Tutorial for AI-driven Scale Development in Generative Psychometrics: Releasing AIGENIE from its Bottle
Organizations: Department of Psychology, University of Virginia, Charlottesville, VA 22903, USA · Department of Psychology, Pontificia Universidad Madre y Maestra, Dominican Republic · Department of Psychology, Vanderbilt University, USA
Abstract
Psychological scale development has traditionally required extensive expert involvement, iterative revision, and large-scale pilot testing before psychometric evaluation can begin. The \texttt{AIGENIE} R package implements the AI-GENIE framework (Automatic Item Generation and Validation with Network-Integrated Evaluation), which integrates large language model (LLM) text generation with network psychometric methods to automate the early stages of this process. The package generates candidate item pools using LLMs, transforms them into high-dimensional embeddings, and applies a multi-step reduction pipeline --- Exploratory Graph Analysis (EGA), Unique Variable Analysis (UVA), and bootstrap EGA --- to produce structurally validated item pools entirely \textit{in silico}. This tutorial introduces the package across eight parts: installation and setup, text generation, embeddings, item generation, the full AI-GENIE pipeline, the GENIE pipeline for researcher-supplied items, advanced prompt engineering, and fully local operation. Two running examples illustrate the package's use: the Big Five personality model (a well-established construct) and AI Anxiety (an emerging construct). The package supports multiple LLM providers (OpenAI, Anthropic, Groq, HuggingFace, and local models), offers a fully offline mode with no external API calls, and provides the \texttt{GENIE()} function for researchers who wish to apply the psychometric reduction pipeline to existing item pools regardless of their origin. The \texttt{AIGENIE} package is freely available on CRAN at https://CRAN.R-project.org/package=AIGENIE.
Figures & tables
| Provider | Model Types | Cost | Website |
|---|---|---|---|
| OpenAI | text and embedding | “Pay as you go” billing. Prepaid credits are also available. | https://platform.openai.com |
| Anthropic | text only | Prepaid credits only. | https://console.anthropic.com |
| Groq | text only | Free base plan with opportunity to upgrade to better rate limits. | https://console.groq.com |
| HuggingFace | text and embedding | Typically free with costs incurring only in special circumstances. | https://huggingface.co |
| Jina AI | embedding only | Free for the first 10 million tokens. | https://jina.ai/embeddings |
| Provider | Notes | Example | Website |
|---|---|---|---|
| OpenAI | Offers state-of-the-art embedding models that have been extensively validated in the AI-GENIE simulations | text-embedding-3-small (the package default) | https://platform.openai.com |
| HuggingFace | An extremely wide ecosystem of open-source embedding models. Most usage is free. | BAAI/bge-base-en-v1.5 | https://huggingface.co |
| Jina AI | Offers competitive open-source models. The first 10 million tokens are free. | jina-embeddings-v4 | https://jina.ai/embeddings |