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()

Release files for losalamos 1.3.9

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.9
File	Size	Uploaded
losalamos-1.3.9.tar.gz	3.2 MB	Sep 21, 2026	Details

Built distribution (wheel)

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

Total release size: 3.5 MB

Release files / losalamos-1.3.9.tar.gz

Download URL	losalamos-1.3.9.tar.gz
Size	3.2 MB
Tags	Source
SHA-256 checksum How to use checksums	`9694e642e1eb675bb11b3750769afa9e10a0bd7865e050164abccf02258ef973`
BLAKE2b-256 checksum How to use checksums	`61bf66d3f4819521c9191d82eae8d0d56343750e54622e8469176c0a28ba8e32`
Upload date	Sep 21, 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.9-py3-none-any.whl

Download URL	losalamos-1.3.9-py3-none-any.whl
Size	333.5 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`aa8decc732bbae2b1542ccf766fd21628f860f5a5287e8944097e9166a40c3de`
BLAKE2b-256 checksum How to use checksums	`414cdb315eb2c829f1b890c8ff398dc2d3522b55e35561eb684dfbe60c0a2b0a`
Upload date	Sep 21, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/7.0.0 CPython/3.11.16`