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.1

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.1
File Size Uploaded Provenance
stillk-0.1.1.tar.gz 15.8 kB Without provenance Details

Built distribution (wheel)

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

Total release size: 31.2 kB

Release files / stillk-0.1.1.tar.gz

Download URL stillk-0.1.1.tar.gz
Size 15.8 kB
Tags Source
SHA-256 checksum
How to use checksums
9784dbd13523b8c3d1e25b09456b7b7a41c8381fd6f9ae7e55a1111a3dbaba65
BLAKE2b-256 checksum
How to use checksums
f6ec9e1f3f99cbd75e11c3d0e120d4dddff249c723575657302561989ec14eef
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.1-py3-none-any.whl

Download URL stillk-0.1.1-py3-none-any.whl
Size 15.4 kB
Tags Python 3
SHA-256 checksum
How to use checksums
3de48edbaa5fab254ba2889476520d02b1953945de7383e051452cbcd1e09a2a
BLAKE2b-256 checksum
How to use checksums
d522bc55735adc41251e2874ff292052ebc057c83301cbc36b463c5d0928e3e6
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.1

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