Documentation
Jan Data Folder

Jan Data Folder

Jan stores your data locally in JSON format. Your data is yours alone.

Open Jan Data Folder

Via Jan:

  1. Settings () > Advanced Settings
  2. Click

Open Jan Data Folder


Via Terminal:


# Windows
cd %APPDATA%/Jan/data
# Mac
cd ~/Library/Application\ Support/Jan/data
# Linux
cd $XDG_CONFIG_HOME/Jan/data # Custom install
cd ~/.config/Jan/data # Default install

Directory Structure

Root directory: ~/jan


/assistants
/jan
assistant.json
/extensions
extensions.json
/@janhq
/extension_A
package.json
/logs
/app.txt
/models
/model_A
model.yaml
model_A.yaml
/settings
settings.json
/@janhq
/extension_A_Settings
settings.json
/themes
/dark-dimmed
/joi-dark
/joi-light
/night-blue
/threads
/jan_thread_A
messages.jsonl
thread.json
messages.jsonl

assistants/

Where AI personalities live. The default one (/assistants/jan/):


{
"avatar": "",
"id": "jan",
"object": "assistant",
"created_at": 1715132389207,
"name": "Jan",
"description": "A default assistant that can use all downloaded models",
"model": "*",
"instructions": ""
}

Parameters:

ParameterDescriptionTypeDefault
idAssistant identifierstringjan
avatarAssistant imagestringNone
objectOpenAI API compatibility markerstringNone
created_atCreation timestampstringNone
nameDisplay namestringJan
descriptionRole descriptionstringDefault
modelAllowed models (* = all)string*
instructionsDefault thread instructionsstringNone
file_idsOpenAI compatibility fieldstringNone
toolsAvailable tools (retrieval only currently)arrayretrieval
typeTool typestringretrieval
enabledTool statusbooleantrue
useTimeWeightedRetrieverTime-weighted retrieval togglebooleanfalse
settingsTool configurationobjectNone
top_kMax retrieval resultsnumber2
chunk_sizeText chunk sizenumber1024
chunk_overlapChunk overlap amountnumber64
retrieval_templateResponse format templatestringNone

extensions/

Add-on central. Organization extensions live in @janhq/, solo ones in root.

logs/

Debugging headquarters (/logs/app.txt):

  • [APP]: Core logs
  • [SERVER]: API drama
  • [SPECS]: Hardware confessions

models/

The silicon brain collection. Each model has its own model.json.

Full parameters: here

settings/

Control panel. Extension settings in /settings/@janhq/:

ParameterDescription
keySetting identifier
titleDisplay name
descriptionSetting explanation
controllerTypeUI component type
controllerPropsComponent properties
extensionNameParent extension link

GPU settings (settings.json):

ParameterDescription
notifyNotification status
run_modeOperating mode
nvidia_driver.existNVIDIA driver presence
nvidia_driver.versionDriver version
cuda.existCUDA availability
cuda.versionCUDA version
gpus[0].idGPU identifier
gpus[0].vramGPU memory (MB)
gpus[0].nameGPU model
gpus[0].archGPU architecture
gpu_highest_vramMost capable GPU
gpus_in_useActive GPUs
is_initialFirst run flag
vulkanVulkan support

themes/

Visual wardrobe. Each theme's theme.json:

ParameterDescription
idTheme identifier
displayNameUI name
reduceTransparentTransparency control
nativeThemeOS theme sync
variablesComponent settings

threads/

Chat archive. Each thread (/threads/jan_unixstamp/) contains:

  • messages.jsonl:

{
"id":"01J6Y6FH8PFTHQB5PNJTHEN27C",
"thread_id":"jan_1725437954",
"type":"Thread",
"role":"assistant",
"content":
[
{
"type": "text",
"text": {
"value": "Hello! Is there something I can help you with or would you like to chat?",
"annotations": []
}
}
],
"status": "ready",
"created": 1725442802966,
"updated": 1725442802966,
"object": "thread.message"
}

  • thread.json:
ParameterDescription
idThread identifier
objectOpenAI compatibility marker
titleThread name
assistantsAssistant configuration clone
modelActive model settings
metadataAdditional thread data

Delete Jan Data

Uninstall guides: Mac, Windows, or Linux.