Markpact: Executable README Runtime

Status: ✅ Production Ready
Wersja: 0.1.x
Repozytorium: github.com/wronai/markpact

Co to jest Markpact?

Markpact to minimalny runtime, który zamienia pliki README.md w wykonywalny kontrakt projektu. Zamiast utrzymywać osobno dokumentację i kod źródłowy, wszystko znajduje się w jednym miejscu.

# Instalacja
pip install markpact[llm]

# Uruchomienie projektu z README
markpact README.md

# Generowanie projektu z opisu
markpact -p "REST API do zarządzania zadaniami" -o todo/README.md --run

Aktualny Status Komponentów

Kluczowe Funkcjonalności

Multi-Language Support

Markpact obsługuje 8 języków programowania z pełnym wsparciem dla zależności i runtime:

• Python (FastAPI, Flask, Django)
• Node.js (Express, Next.js)
• Go
• Rust
• PHP (Laravel)
• TypeScript
• React
• Static HTML

Integracja LLM

Generowanie kompletnych projektów z opisu tekstowego:

# Z lokalnego Ollama
markpact config --provider ollama
markpact -p "Chat WebSocket z FastAPI" -o chat/README.md --run

# Z OpenRouter (darmowe modele)
markpact config --provider openrouter --api-key sk-or-v1-xxxxx
markpact -p "URL shortener z Redis" -o url/README.md --run

Obsługiwane providery: Ollama, OpenRouter, OpenAI, Anthropic, Groq

Konwersja Notebooków

markpact --from-notebook notebook.ipynb -o project/README.md --run

Obsługiwane formaty: Jupyter (.ipynb), R Markdown (.Rmd), Quarto (.qmd), Databricks, Zeppelin

Kontrakt markpact:* (Codeblocki)

# Mój Projekt

\`\`\`markpact:deps python
fastapi
uvicorn
\`\`\`

\`\`\`markpact:file python path=app/main.py
from fastapi import FastAPI
app = FastAPI()

@app.get("/")
def root():
    return {"message": "Hello World"}
\`\`\`

\`\`\`markpact:run python
uvicorn app.main:app --host 0.0.0.0 --port ${MARKPACT_PORT:-8000}
\`\`\`

Roadmap Q1-Q2 2026

• Integracja z Pactown orchestrator (v0.1.141)
• Desktop/Mobile builds z markpact (Electron, Tauri, Capacitor, Kivy)
• IaC artifact generation (Dockerfile, docker-compose, sandbox.yaml)
• Markpact v0.2 – ulepszony auto-fix
• Web editor z live preview
• Plugin system dla custom codeblocków
• Marketplace templatek

Linki

• GitHub: github.com/wronai/markpact
• PyPI: pypi.org/project/markpact
• Dokumentacja: docs/README.md

---

Ostatnia aktualizacja: 10 lutego 2026