Style Status Docs Status Tests Status Top Language Status

Los Alamos

A Python toolkit for productivity and research.

Install easily

python -m pip install losalamos

Quick Gallery

Project

Create and manage structured project folders with metadata, financial tracking, and document generation.

import losalamos

# create a project — builds folder structure and installs the Obsidian note
pj = losalamos.new_project(config={
    "folder_base": "/projects",
    "name": "Survey2026",
    "title": "Environmental Survey 2026",
    "status": "planning",
    "sources": "/vault/sources.toml",
})

# load an existing project
pj = losalamos.load_project(project_folder="/projects/Survey2026")

# query assets and financial transfers as DataFrames
assets    = pj.get_assets()
transfers = pj.get_transfers()

# issue an invoice and build its PDF
pj.add_invoice()
pj.build_invoice(file_id="INV-001")

Notes

Structured Markdown notes backed by YAML frontmatter, Obsidian-ready templates, and typed collections.

from losalamos.notes import NoteProject, NoteReference, NoteCollection

# load and inspect a project note
note = NoteProject()
note.load(file_note="Survey2026/Survey2026.md")
print(note.metadata["title"])

# create a reference note from BibTeX metadata
ref = NoteReference()
ref.load_new(
    file_note="smith2022.md",
    metadata={
        "entry_type": "article",
        "name":       "smith2022",
        "author":     "Smith, John and Doe, Jane",
        "title":      "River flow trends under climate change",
        "year":       "2022",
        "journal":    "Hydrology Journal",
    },
)
ref.save()

# scan a folder as a typed collection
coll = NoteCollection()
coll.load_folder("vault/notes/projects")
for n in coll:
    print(n.name, n.metadata.get("status"))

# rename a note and propagate the link update across the vault
note = NoteProject()
note.load(file_note="old_name.md")
note.refactor(new_name="new_name", scope="vault/notes")

Documents

Scaffold TeX documents from layered templates with optional private overlays.

from losalamos.documents import Report

# create a report from the built-in template
report = Report(name="AnnualReport", alias="AR")
report.new(folder="/projects/Survey2026/outputs", name="annual_report")

# apply a client-specific overlay (logos, cover page, etc.)
report.new(
    folder="/projects/Survey2026/outputs",
    name="client_report",
    template_overlay="/private/client_x",
)

Figures

Raster image utilities and Inkscape SVG manipulation with multi-format export.

from losalamos.figures import Figure, FigureSVG

# generate a JPEG thumbnail from any raster image
Figure.make_thumbnail(
    file_input="photo.png",
    file_output="thumb.jpg",
    size=(512, 512),
    mode="crop",
)

# load an Inkscape SVG and export to PDF hiding selected layers
svg = FigureSVG()
svg.load_data(file_data="diagram.svg")
svg.to_pdf(file_output="diagram.pdf", hide_layers=["annotations"])

# or render a PNG with only specific layers visible
svg.to_image(file_output="figure.png", dpi=300, show_layers=["background", "data"])

Ingestion

Automated PDF + BibTeX ingestion pipeline for managed reference libraries.

from losalamos.ingestion import Ingester

# pair PDFs with their BibTeX files, normalize metadata,
# create reference notes, and copy PDFs into the library
ing = Ingester(src="incoming/papers", dst="library/papers")
ing.run()

Metadata

Release files for losalamos 1.3.14

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for losalamos 1.3.14
File	Size	Uploaded
losalamos-1.3.14.tar.gz	3.2 MB	Sep 30, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for losalamos 1.3.14
File	Interpreter	ABI	Platform	Reset
losalamos-1.3.14-py3-none-any.whl 348.6 kB Sep 30, 2026	Python 3	none	any	Details

Total release size: 3.5 MB

Release files / losalamos-1.3.14.tar.gz

Download URL	losalamos-1.3.14.tar.gz
Size	3.2 MB
Tags	Source
SHA-256 checksum How to use checksums	`c18733f1dfa8625c9fd328b545211592d0a9d1c5880650a2f9663a0548468f6b`
BLAKE2b-256 checksum How to use checksums	`523bb5d713655383e2463c1152223201404d292e43ca2573407b7fd852e534a1`
Upload date	Sep 30, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/7.0.0 CPython/3.11.16`

Release files / losalamos-1.3.14-py3-none-any.whl

Download URL	losalamos-1.3.14-py3-none-any.whl
Size	348.6 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`2a004db0b08079b0ce6a133858e62b4605a491c69fff70c3367a4a6cad117944`
BLAKE2b-256 checksum How to use checksums	`ecceab5c5ea855fa77c4717a596d6acbbb9543cd7070b32ab21c9bf4a8f0c763`
Upload date	Sep 30, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/7.0.0 CPython/3.11.16`