fn_registry/python/functions/obsidian/create_obsidian_vault.md

name, kind, lang, domain, version, purity, signature, description, tags, uses_functions, uses_types, returns, returns_optional, error_type, imports, params, output, tested, tests, test_file_path, file_path

name	kind	lang	domain	version	purity	signature	description	tags	uses_functions	uses_types	returns	returns_optional	error_type	imports	params	output	tested	tests	test_file_path	file_path
create_obsidian_vault	function	py	obsidian	1.0.0	impure	create_obsidian_vault(parent_dir: str, name: str) -> str	Crea un vault de Obsidian nuevo: parent_dir/name/ + parent_dir/name/.obsidian/app.json con {} (config minima valida). Lanza error si el vault ya existe (ya tiene .obsidian/). Devuelve el path absoluto del vault.	obsidian vault create crud filesystem				false	error_go_core	json os	name desc parent_dir directorio bajo el cual se crea la carpeta del vault; se crea si no existe name desc name nombre de la carpeta del nuevo vault (un solo segmento de path, sin separadores)	path absoluto del directorio del vault creado	false			python/functions/obsidian/create_obsidian_vault.py

Ejemplo

from obsidian import create_obsidian_vault

path = create_obsidian_vault("/home/enmanuel/Obsidian", "Proyectos2026")
print(path)  # /home/enmanuel/Obsidian/Proyectos2026
# Crea ademas /home/enmanuel/Obsidian/Proyectos2026/.obsidian/app.json -> {}

Cuando usarla

Cuando necesites crear un vault de Obsidian listo para abrir desde cero (scaffolding de un workspace nuevo, automatizar la creacion de vaults por proyecto) sin pasar por la GUI de Obsidian.

Gotchas

• Impura: escribe en el filesystem. Crea parent_dir/name/.obsidian/ y un app.json con {} (config minima que Obsidian reconoce como vault valido).
• No sobrescribe: si el destino ya parece un vault (ya tiene .obsidian/) lanza FileExistsError; nunca pisa un vault existente.
• Nombre validado: lanza ValueError si name es vacio o contiene un separador de path (/), para evitar crear estructuras anidadas accidentales.
• Lo que hace vault a una carpeta es la presencia de .obsidian/; este es el mismo criterio que usa list_obsidian_vaults para descubrir vaults, asi que un vault recien creado aparece de inmediato en ese listado.
• parent_dir se crea si no existe (makedirs), de modo que se puede crear un vault en una ruta nueva en una sola llamada.