Skip to main content

Stillk

Stillk is an open-source scaffolding CLI for machine learning, deep learning, LLM, RAG, and AI agent projects. It follows a create-react-app-inspired workflow so teams can generate a production-ready project skeleton in seconds.

Why Stillk

  • Generate a complete starter project with real folders and working files
  • Support ML, DL, LLM, RAG, and AI agents from day one
  • Modular registry-based template system for future growth
  • Open source and designed for community-driven extension

Features

  • stillk init <project-name> to bootstrap a project
  • Interactive project selection when flags are omitted
  • Built-in templates for ML and LLM flows
  • Pre-generated pyproject.toml, README.md, Dockerfile, .env.example, tests, and source folders
  • Future plugin-ready command: stillk add mlflow, stillk add rag, stillk add fastapi

Installation

pip install stillk

For local development:

python -m venv .venv
source .venv/bin/activate
pip install -e .[dev]

Quick start

stillk init meu-projeto --project-type ml --framework scikit-learn
stillk init meu-llm --project-type llm --framework transformers
stillk init

AI Engineering Toolkit commands

Stillk now includes runtime tooling to help during development, training and maintenance:

  • stillk inspect — analyze the current project for frameworks, models, datasets, Docker, GPU and give warnings.
  • stillk doctor — run quick environment checks (Python, pip, Docker, GPU, PyTorch/TensorFlow).
  • stillk clean — detect caches and temporary artifacts and optionally remove them (--yes).
  • stillk train — detect training scripts and (optionally) execute them (--execute).
  • stillk eval — run or detect evaluation pipelines and report metrics.
  • stillk benchmark — lightweight benchmarking scaffold for models and pipelines.
  • stillk run <component> — run project components such as api, training, inference.

The interactive mode asks for:

  • project type
  • framework
  • output folder
  • project metadata

Generated project structure

meu-projeto/
├── src/
│   ├── data/
│   ├── features/
│   ├── models/
│   ├── training/
│   ├── inference/
│   ├── api/
│   ├── agents/
│   ├── graph/
│   ├── prompts/
│   ├── retrieval/
│   ├── embeddings/
│   ├── vectorstore/
│   └── evals/
├── data/
│   ├── raw/
│   ├── processed/
│   └── external/
├── configs/
├── notebooks/
├── tests/
├── scripts/
├── Dockerfile
├── pyproject.toml
├── README.md
├── .env.example
├── .gitignore
├── main.py
├── preprocessing.py
└── .github/

Supported types

  • Machine Learning
  • Deep Learning
  • LLM
  • RAG
  • AI Agents

Supported frameworks

  • Scikit-learn
  • PyTorch
  • XGBoost
  • Transformers
  • LangGraph

Publishing to PyPI

To build the package:

python -m pip install -U build twine
python -m build

To publish:

python -m twine upload dist/*

Before publishing, configure your PyPI API token in your environment or use a trusted publishing workflow.

Contributing

Contributions are welcome. Please open an issue or pull request with tests for new templates or features.

License

MIT

Copyright (c) 2026 Lucas Balduino - Stillk

Metadata

Release files for stillk 0.1.2

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

Source distribution (sdist)

Source distribution for stillk 0.1.2
File Size Uploaded Provenance
stillk-0.1.2.tar.gz 16.2 kB Without provenance Details

Built distribution (wheel)

Table of built distributions (wheels) for stillk 0.1.2
File Interpreter ABI Platform
stillk-0.1.2-py3-none-any.whl Python 3 none any Details

Total release size: 31.9 kB

Release files / stillk-0.1.2.tar.gz

Download URL stillk-0.1.2.tar.gz
Size 16.2 kB
Tags Source
SHA-256 checksum
How to use checksums
c95feba056b9c98ddaf73d3dbff8028bb1c7fbcd06949dedd76bde57d3fefe42
BLAKE2b-256 checksum
How to use checksums
76b114a2658a250f51172e2d98826b32b72e44100ca5261c12fb0fa5280a67e0
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.12.0

Release files / stillk-0.1.2-py3-none-any.whl

Download URL stillk-0.1.2-py3-none-any.whl
Size 15.7 kB
Tags Python 3
SHA-256 checksum
How to use checksums
91280d326877fd87613ac34b69bb62b068865ab676cf32fc7b6cdbbb08e5f947
BLAKE2b-256 checksum
How to use checksums
d456f76f4ff1a6265124ca65bececfc52f097e32ab3467e9c4fe2044b7f7590f
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.12.0

Security for stillk 0.1.2

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page