makker 0.3.0rc1__tar.gz
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- makker-0.3.0rc1/.gitignore +55 -0
- makker-0.3.0rc1/AGENTS.md +190 -0
- makker-0.3.0rc1/LICENSE +21 -0
- makker-0.3.0rc1/PKG-INFO +157 -0
- makker-0.3.0rc1/README.md +116 -0
- makker-0.3.0rc1/bridge/jutul-agent/README.md +20 -0
- makker-0.3.0rc1/bridge/jutul-agent/pyproject.toml +38 -0
- makker-0.3.0rc1/docs/README.md +105 -0
- makker-0.3.0rc1/docs/adding-a-simulator.md +185 -0
- makker-0.3.0rc1/docs/agent-first.md +182 -0
- makker-0.3.0rc1/docs/approval.md +73 -0
- makker-0.3.0rc1/docs/architecture.md +232 -0
- makker-0.3.0rc1/docs/assets/architecture-dark.svg +708 -0
- makker-0.3.0rc1/docs/assets/architecture-light.svg +708 -0
- makker-0.3.0rc1/docs/assets/architecture.tex +170 -0
- makker-0.3.0rc1/docs/assets/favicon.svg +4 -0
- makker-0.3.0rc1/docs/assets/render-architecture.sh +14 -0
- makker-0.3.0rc1/docs/benchmark-records.jsonl +492 -0
- makker-0.3.0rc1/docs/benchmark.md +236 -0
- makker-0.3.0rc1/docs/cli.md +232 -0
- makker-0.3.0rc1/docs/configuration.md +115 -0
- makker-0.3.0rc1/docs/context.md +102 -0
- makker-0.3.0rc1/docs/development.md +179 -0
- makker-0.3.0rc1/docs/evaluation.md +281 -0
- makker-0.3.0rc1/docs/extending-for-your-application.md +160 -0
- makker-0.3.0rc1/docs/filesystem.md +59 -0
- makker-0.3.0rc1/docs/images/review-dashboard.png +0 -0
- makker-0.3.0rc1/docs/images/web-battmo.png +0 -0
- makker-0.3.0rc1/docs/images/web-fimbul.png +0 -0
- makker-0.3.0rc1/docs/images/web-jutuldarcy.png +0 -0
- makker-0.3.0rc1/docs/improving-the-agent.md +89 -0
- makker-0.3.0rc1/docs/julia-kernel.md +108 -0
- makker-0.3.0rc1/docs/lab.md +110 -0
- makker-0.3.0rc1/docs/memory.md +58 -0
- makker-0.3.0rc1/docs/models.md +116 -0
- makker-0.3.0rc1/docs/review.md +187 -0
- makker-0.3.0rc1/docs/server-interface.md +432 -0
- makker-0.3.0rc1/docs/stylesheets/extra.css +223 -0
- makker-0.3.0rc1/docs/sysimage.md +222 -0
- makker-0.3.0rc1/docs/testing.md +102 -0
- makker-0.3.0rc1/docs/trace.md +91 -0
- makker-0.3.0rc1/docs/turns.md +81 -0
- makker-0.3.0rc1/docs/usage.md +311 -0
- makker-0.3.0rc1/docs/web-ui.md +99 -0
- makker-0.3.0rc1/examples/demo-app/README.md +49 -0
- makker-0.3.0rc1/pyproject.toml +150 -0
- makker-0.3.0rc1/src/makker/__init__.py +33 -0
- makker-0.3.0rc1/src/makker/__main__.py +23 -0
- makker-0.3.0rc1/src/makker/_version.py +24 -0
- makker-0.3.0rc1/src/makker/agent/__init__.py +0 -0
- makker-0.3.0rc1/src/makker/agent/added_dirs.py +117 -0
- makker-0.3.0rc1/src/makker/agent/approval.py +278 -0
- makker-0.3.0rc1/src/makker/agent/backend.py +160 -0
- makker-0.3.0rc1/src/makker/agent/builder.py +530 -0
- makker-0.3.0rc1/src/makker/agent/capabilities.py +355 -0
- makker-0.3.0rc1/src/makker/agent/context_editing.py +74 -0
- makker-0.3.0rc1/src/makker/agent/memory.py +267 -0
- makker-0.3.0rc1/src/makker/agent/openrouter.py +34 -0
- makker-0.3.0rc1/src/makker/agent/plot_julia.py +784 -0
- makker-0.3.0rc1/src/makker/agent/plot_julia_src.py +806 -0
- makker-0.3.0rc1/src/makker/agent/prompts.py +244 -0
- makker-0.3.0rc1/src/makker/agent/recovery.py +127 -0
- makker-0.3.0rc1/src/makker/agent/summarization.py +163 -0
- makker-0.3.0rc1/src/makker/agent/titling.py +60 -0
- makker-0.3.0rc1/src/makker/agent/tool_output.py +86 -0
- makker-0.3.0rc1/src/makker/agent/tools.py +358 -0
- makker-0.3.0rc1/src/makker/agent/turns.py +431 -0
- makker-0.3.0rc1/src/makker/agent/windows_paths.py +133 -0
- makker-0.3.0rc1/src/makker/approval_preview.py +270 -0
- makker-0.3.0rc1/src/makker/context_panel.py +239 -0
- makker-0.3.0rc1/src/makker/credentials.py +163 -0
- makker-0.3.0rc1/src/makker/display.py +188 -0
- makker-0.3.0rc1/src/makker/eval/__init__.py +22 -0
- makker-0.3.0rc1/src/makker/eval/_gemini_compat.py +65 -0
- makker-0.3.0rc1/src/makker/eval/report.py +475 -0
- makker-0.3.0rc1/src/makker/eval/runconfig.py +91 -0
- makker-0.3.0rc1/src/makker/eval/scorers.py +712 -0
- makker-0.3.0rc1/src/makker/eval/solver.py +295 -0
- makker-0.3.0rc1/src/makker/eval/tasks/__init__.py +1 -0
- makker-0.3.0rc1/src/makker/eval/tasks/_corpus/MiniRes/Project.toml +3 -0
- makker-0.3.0rc1/src/makker/eval/tasks/_corpus/MiniRes/README.md +4 -0
- makker-0.3.0rc1/src/makker/eval/tasks/_corpus/MiniRes/docs/api.md +7 -0
- makker-0.3.0rc1/src/makker/eval/tasks/_corpus/MiniRes/examples/advanced/sweep.jl +8 -0
- makker-0.3.0rc1/src/makker/eval/tasks/_corpus/MiniRes/examples/quickstart.jl +6 -0
- makker-0.3.0rc1/src/makker/eval/tasks/_corpus/MiniRes/src/MiniRes.jl +13 -0
- makker-0.3.0rc1/src/makker/eval/tasks/_corpus/MiniRes/src/grid.jl +8 -0
- makker-0.3.0rc1/src/makker/eval/tasks/_corpus/MiniRes/src/physics/darcy.jl +13 -0
- makker-0.3.0rc1/src/makker/eval/tasks/_corpus/MiniRes/src/physics/wells.jl +15 -0
- makker-0.3.0rc1/src/makker/eval/tasks/_corpus/MiniRes/src/solver/newton.jl +15 -0
- makker-0.3.0rc1/src/makker/eval/tasks/_corpus/__init__.py +54 -0
- makker-0.3.0rc1/src/makker/eval/tasks/api_discovery.py +122 -0
- makker-0.3.0rc1/src/makker/eval/tasks/battmo.py +88 -0
- makker-0.3.0rc1/src/makker/eval/tasks/calibration.py +82 -0
- makker-0.3.0rc1/src/makker/eval/tasks/canary.py +41 -0
- makker-0.3.0rc1/src/makker/eval/tasks/ensembles.py +209 -0
- makker-0.3.0rc1/src/makker/eval/tasks/filesystem.py +290 -0
- makker-0.3.0rc1/src/makker/eval/tasks/filesystem_source.py +80 -0
- makker-0.3.0rc1/src/makker/eval/tasks/fimbul.py +51 -0
- makker-0.3.0rc1/src/makker/eval/tasks/guardrails.py +47 -0
- makker-0.3.0rc1/src/makker/eval/tasks/jutuldarcy.py +139 -0
- makker-0.3.0rc1/src/makker/eval/tasks/mocca.py +90 -0
- makker-0.3.0rc1/src/makker/eval/tasks/plotting.py +111 -0
- makker-0.3.0rc1/src/makker/eval/tasks/search.py +211 -0
- makker-0.3.0rc1/src/makker/eval/tasks/search_source.py +71 -0
- makker-0.3.0rc1/src/makker/eval/tasks/usage.py +138 -0
- makker-0.3.0rc1/src/makker/interfaces/__init__.py +0 -0
- makker-0.3.0rc1/src/makker/interfaces/cli/__init__.py +10 -0
- makker-0.3.0rc1/src/makker/interfaces/cli/_helpers.py +197 -0
- makker-0.3.0rc1/src/makker/interfaces/cli/doctor.py +427 -0
- makker-0.3.0rc1/src/makker/interfaces/cli/eval.py +198 -0
- makker-0.3.0rc1/src/makker/interfaces/cli/init.py +268 -0
- makker-0.3.0rc1/src/makker/interfaces/cli/key.py +117 -0
- makker-0.3.0rc1/src/makker/interfaces/cli/main.py +207 -0
- makker-0.3.0rc1/src/makker/interfaces/cli/review.py +538 -0
- makker-0.3.0rc1/src/makker/interfaces/cli/run.py +412 -0
- makker-0.3.0rc1/src/makker/interfaces/cli/sessions.py +45 -0
- makker-0.3.0rc1/src/makker/interfaces/cli/sysimage.py +223 -0
- makker-0.3.0rc1/src/makker/interfaces/cli/transcript.py +102 -0
- makker-0.3.0rc1/src/makker/interfaces/cli/upgrade.py +369 -0
- makker-0.3.0rc1/src/makker/interfaces/cli/web.py +314 -0
- makker-0.3.0rc1/src/makker/interfaces/server/__init__.py +13 -0
- makker-0.3.0rc1/src/makker/interfaces/server/access.py +148 -0
- makker-0.3.0rc1/src/makker/interfaces/server/app.py +2443 -0
- makker-0.3.0rc1/src/makker/interfaces/server/manager.py +292 -0
- makker-0.3.0rc1/src/makker/interfaces/server/protocol.py +321 -0
- makker-0.3.0rc1/src/makker/interfaces/server/update_helper.py +199 -0
- makker-0.3.0rc1/src/makker/interfaces/server/updates.py +446 -0
- makker-0.3.0rc1/src/makker/interfaces/server/web_dist/assets/index-BcWXsrUW.js +54 -0
- makker-0.3.0rc1/src/makker/interfaces/server/web_dist/assets/index-Cbigi-bs.css +1 -0
- makker-0.3.0rc1/src/makker/interfaces/server/web_dist/index.html +17 -0
- makker-0.3.0rc1/src/makker/interfaces/tui/__init__.py +5 -0
- makker-0.3.0rc1/src/makker/interfaces/tui/app.py +1779 -0
- makker-0.3.0rc1/src/makker/interfaces/tui/approval_menu.py +227 -0
- makker-0.3.0rc1/src/makker/interfaces/tui/commands.py +143 -0
- makker-0.3.0rc1/src/makker/interfaces/tui/model_menu.py +416 -0
- makker-0.3.0rc1/src/makker/interfaces/tui/prompt.py +210 -0
- makker-0.3.0rc1/src/makker/interfaces/tui/tool_display.py +440 -0
- makker-0.3.0rc1/src/makker/interfaces/tui/widgets.py +991 -0
- makker-0.3.0rc1/src/makker/julia/__init__.py +0 -0
- makker-0.3.0rc1/src/makker/julia/precompile.py +120 -0
- makker-0.3.0rc1/src/makker/julia/requirements.py +101 -0
- makker-0.3.0rc1/src/makker/julia/session.py +49 -0
- makker-0.3.0rc1/src/makker/julia/threads.py +126 -0
- makker-0.3.0rc1/src/makker/julia_runtime/Makker/Project.toml +21 -0
- makker-0.3.0rc1/src/makker/julia_runtime/Makker/src/Makker.jl +99 -0
- makker-0.3.0rc1/src/makker/julia_runtime/Makker/src/ensemble.jl +104 -0
- makker-0.3.0rc1/src/makker/julia_runtime/Makker/src/plots.jl +292 -0
- makker-0.3.0rc1/src/makker/julia_runtime/Makker/src/web_views.jl +77 -0
- makker-0.3.0rc1/src/makker/juliakernel/__init__.py +19 -0
- makker-0.3.0rc1/src/makker/juliakernel/config.py +35 -0
- makker-0.3.0rc1/src/makker/juliakernel/connection.py +261 -0
- makker-0.3.0rc1/src/makker/juliakernel/kernel.py +509 -0
- makker-0.3.0rc1/src/makker/juliakernel/result.py +37 -0
- makker-0.3.0rc1/src/makker/juliakernel/server.jl +263 -0
- makker-0.3.0rc1/src/makker/juliakernel/text.py +211 -0
- makker-0.3.0rc1/src/makker/lab/__init__.py +19 -0
- makker-0.3.0rc1/src/makker/lab/fakes.py +744 -0
- makker-0.3.0rc1/src/makker/lab/live.py +225 -0
- makker-0.3.0rc1/src/makker/lab/profile_startup.py +144 -0
- makker-0.3.0rc1/src/makker/lab/profile_turn.py +70 -0
- makker-0.3.0rc1/src/makker/lab/rasterize.py +73 -0
- makker-0.3.0rc1/src/makker/lab/scenarios.py +255 -0
- makker-0.3.0rc1/src/makker/lab/tui.py +194 -0
- makker-0.3.0rc1/src/makker/legacy.py +298 -0
- makker-0.3.0rc1/src/makker/models.py +441 -0
- makker-0.3.0rc1/src/makker/ollama_client.py +177 -0
- makker-0.3.0rc1/src/makker/open_file.py +54 -0
- makker-0.3.0rc1/src/makker/paths.py +205 -0
- makker-0.3.0rc1/src/makker/preview.py +70 -0
- makker-0.3.0rc1/src/makker/py.typed +0 -0
- makker-0.3.0rc1/src/makker/recent_models.py +47 -0
- makker-0.3.0rc1/src/makker/review/__init__.py +40 -0
- makker-0.3.0rc1/src/makker/review/curate.py +135 -0
- makker-0.3.0rc1/src/makker/review/dashboard.py +216 -0
- makker-0.3.0rc1/src/makker/review/dashboard_template.html +384 -0
- makker-0.3.0rc1/src/makker/review/discovery.py +159 -0
- makker-0.3.0rc1/src/makker/review/eval_link.py +81 -0
- makker-0.3.0rc1/src/makker/review/export.py +74 -0
- makker-0.3.0rc1/src/makker/review/findings.py +176 -0
- makker-0.3.0rc1/src/makker/review/issues.py +190 -0
- makker-0.3.0rc1/src/makker/review/prompt.py +195 -0
- makker-0.3.0rc1/src/makker/review/reviewer.py +195 -0
- makker-0.3.0rc1/src/makker/review/server.py +109 -0
- makker-0.3.0rc1/src/makker/review/settings.py +28 -0
- makker-0.3.0rc1/src/makker/session.py +510 -0
- makker-0.3.0rc1/src/makker/session_host.py +696 -0
- makker-0.3.0rc1/src/makker/simulators/README.md +50 -0
- makker-0.3.0rc1/src/makker/simulators/__init__.py +0 -0
- makker-0.3.0rc1/src/makker/simulators/base.py +63 -0
- makker-0.3.0rc1/src/makker/simulators/battmo/__init__.py +3 -0
- makker-0.3.0rc1/src/makker/simulators/battmo/adapter.py +39 -0
- makker-0.3.0rc1/src/makker/simulators/battmo/julia_env/MakkerBattMo/Project.toml +21 -0
- makker-0.3.0rc1/src/makker/simulators/battmo/julia_env/MakkerBattMo/src/MakkerBattMo.jl +43 -0
- makker-0.3.0rc1/src/makker/simulators/battmo/julia_env/Project.toml +34 -0
- makker-0.3.0rc1/src/makker/simulators/battmo/skills/battmo-cycling/SKILL.md +33 -0
- makker-0.3.0rc1/src/makker/simulators/battmo/skills/battmo-overview/SKILL.md +55 -0
- makker-0.3.0rc1/src/makker/simulators/battmo/skills/battmo-plotting/SKILL.md +46 -0
- makker-0.3.0rc1/src/makker/simulators/env_setup.py +980 -0
- makker-0.3.0rc1/src/makker/simulators/fimbul/__init__.py +3 -0
- makker-0.3.0rc1/src/makker/simulators/fimbul/adapter.py +43 -0
- makker-0.3.0rc1/src/makker/simulators/fimbul/julia_env/MakkerFimbul/Project.toml +23 -0
- makker-0.3.0rc1/src/makker/simulators/fimbul/julia_env/MakkerFimbul/src/MakkerFimbul.jl +89 -0
- makker-0.3.0rc1/src/makker/simulators/fimbul/julia_env/Project.toml +40 -0
- makker-0.3.0rc1/src/makker/simulators/fimbul/skills/fimbul-overview/SKILL.md +72 -0
- makker-0.3.0rc1/src/makker/simulators/fimbul/skills/fimbul-plotting/SKILL.md +69 -0
- makker-0.3.0rc1/src/makker/simulators/jutuldarcy/__init__.py +3 -0
- makker-0.3.0rc1/src/makker/simulators/jutuldarcy/adapter.py +41 -0
- makker-0.3.0rc1/src/makker/simulators/jutuldarcy/julia_env/MakkerJutulDarcy/Project.toml +24 -0
- makker-0.3.0rc1/src/makker/simulators/jutuldarcy/julia_env/MakkerJutulDarcy/src/MakkerJutulDarcy.jl +149 -0
- makker-0.3.0rc1/src/makker/simulators/jutuldarcy/julia_env/Project.toml +37 -0
- makker-0.3.0rc1/src/makker/simulators/jutuldarcy/skills/jutuldarcy-overview/SKILL.md +82 -0
- makker-0.3.0rc1/src/makker/simulators/jutuldarcy/skills/jutuldarcy-plotting/SKILL.md +74 -0
- makker-0.3.0rc1/src/makker/simulators/jutuldarcy/skills/jutuldarcy-wells/SKILL.md +67 -0
- makker-0.3.0rc1/src/makker/simulators/mocca/__init__.py +3 -0
- makker-0.3.0rc1/src/makker/simulators/mocca/adapter.py +40 -0
- makker-0.3.0rc1/src/makker/simulators/mocca/julia_env/MakkerMocca/Project.toml +22 -0
- makker-0.3.0rc1/src/makker/simulators/mocca/julia_env/MakkerMocca/src/MakkerMocca.jl +55 -0
- makker-0.3.0rc1/src/makker/simulators/mocca/julia_env/Project.toml +35 -0
- makker-0.3.0rc1/src/makker/simulators/mocca/skills/mocca-overview/SKILL.md +125 -0
- makker-0.3.0rc1/src/makker/simulators/registry.py +147 -0
- makker-0.3.0rc1/src/makker/simulators/shared_skills/ensembles/SKILL.md +94 -0
- makker-0.3.0rc1/src/makker/simulators/shared_skills/investigation-loop/SKILL.md +101 -0
- makker-0.3.0rc1/src/makker/simulators/shared_skills/julia-and-repl/SKILL.md +93 -0
- makker-0.3.0rc1/src/makker/simulators/shared_skills/plotting-basics/SKILL.md +138 -0
- makker-0.3.0rc1/src/makker/simulators/shared_skills/workspace-and-source/SKILL.md +110 -0
- makker-0.3.0rc1/src/makker/simulators/warmup.py +212 -0
- makker-0.3.0rc1/src/makker/sysimage.py +548 -0
- makker-0.3.0rc1/src/makker/sysimage_build.py +881 -0
- makker-0.3.0rc1/src/makker/tool_labels.py +35 -0
- makker-0.3.0rc1/src/makker/trace/__init__.py +10 -0
- makker-0.3.0rc1/src/makker/trace/log.py +155 -0
- makker-0.3.0rc1/src/makker/trace/messages.py +46 -0
- makker-0.3.0rc1/src/makker/trace/recorder.py +141 -0
- makker-0.3.0rc1/src/makker/trace/schema.py +129 -0
- makker-0.3.0rc1/src/makker/transcript/__init__.py +8 -0
- makker-0.3.0rc1/src/makker/transcript/attempts.py +67 -0
- makker-0.3.0rc1/src/makker/transcript/bundle.py +18 -0
- makker-0.3.0rc1/src/makker/transcript/embed.py +55 -0
- makker-0.3.0rc1/src/makker/transcript/events.py +77 -0
- makker-0.3.0rc1/src/makker/transcript/highlight.py +143 -0
- makker-0.3.0rc1/src/makker/transcript/html.py +1031 -0
- makker-0.3.0rc1/src/makker/transcript/markdown.py +176 -0
- makker-0.3.0rc1/src/makker/transcript/markdown_html.py +65 -0
- makker-0.3.0rc1/src/makker/transcript/report.py +1076 -0
- makker-0.3.0rc1/src/makker/update_check.py +329 -0
- makker-0.3.0rc1/src/makker/user_config.py +51 -0
- makker-0.3.0rc1/src/makker/workspace.py +1130 -0
- makker-0.3.0rc1/tests/__snapshots__/test_report_renderer.ambr +340 -0
- makker-0.3.0rc1/tests/__snapshots__/test_transcript.ambr +75 -0
- makker-0.3.0rc1/tests/__snapshots__/test_transcript_html.ambr +7149 -0
- makker-0.3.0rc1/tests/_tui.py +27 -0
- makker-0.3.0rc1/tests/conftest.py +113 -0
- makker-0.3.0rc1/tests/integration/test_julia_plot_integration.py +493 -0
- makker-0.3.0rc1/tests/integration/web_capture.jl +67 -0
- makker-0.3.0rc1/tests/integration/web_views.jl +66 -0
- makker-0.3.0rc1/tests/live/README.md +48 -0
- makker-0.3.0rc1/tests/live/test_live_smoke.py +90 -0
- makker-0.3.0rc1/tests/test_added_dirs.py +102 -0
- makker-0.3.0rc1/tests/test_approval.py +171 -0
- makker-0.3.0rc1/tests/test_approval_menu.py +28 -0
- makker-0.3.0rc1/tests/test_approval_mode.py +75 -0
- makker-0.3.0rc1/tests/test_attempt_tree.py +56 -0
- makker-0.3.0rc1/tests/test_bridge.py +151 -0
- makker-0.3.0rc1/tests/test_builder.py +364 -0
- makker-0.3.0rc1/tests/test_capabilities.py +304 -0
- makker-0.3.0rc1/tests/test_chat_app.py +1481 -0
- makker-0.3.0rc1/tests/test_chat_integration.py +166 -0
- makker-0.3.0rc1/tests/test_cli_init.py +152 -0
- makker-0.3.0rc1/tests/test_cli_key.py +58 -0
- makker-0.3.0rc1/tests/test_cli_resume.py +64 -0
- makker-0.3.0rc1/tests/test_cli_startup.py +57 -0
- makker-0.3.0rc1/tests/test_cli_transcript.py +182 -0
- makker-0.3.0rc1/tests/test_cli_upgrade.py +243 -0
- makker-0.3.0rc1/tests/test_cli_web.py +156 -0
- makker-0.3.0rc1/tests/test_context_editing.py +89 -0
- makker-0.3.0rc1/tests/test_context_panel.py +117 -0
- makker-0.3.0rc1/tests/test_credentials.py +148 -0
- makker-0.3.0rc1/tests/test_deepagents_canaries.py +55 -0
- makker-0.3.0rc1/tests/test_demo_app.py +77 -0
- makker-0.3.0rc1/tests/test_display.py +133 -0
- makker-0.3.0rc1/tests/test_doctor.py +85 -0
- makker-0.3.0rc1/tests/test_doctor_plotting.py +49 -0
- makker-0.3.0rc1/tests/test_doctor_sysimage.py +77 -0
- makker-0.3.0rc1/tests/test_end_to_end.py +383 -0
- makker-0.3.0rc1/tests/test_env_setup.py +913 -0
- makker-0.3.0rc1/tests/test_env_template_stamp.py +218 -0
- makker-0.3.0rc1/tests/test_ephemeral_memory.py +57 -0
- makker-0.3.0rc1/tests/test_eval_bench.py +684 -0
- makker-0.3.0rc1/tests/test_eval_report.py +156 -0
- makker-0.3.0rc1/tests/test_eval_scorers.py +35 -0
- makker-0.3.0rc1/tests/test_highlight.py +37 -0
- makker-0.3.0rc1/tests/test_host_context.py +459 -0
- makker-0.3.0rc1/tests/test_julia_precompile.py +114 -0
- makker-0.3.0rc1/tests/test_julia_requirements.py +94 -0
- makker-0.3.0rc1/tests/test_julia_streaming.py +75 -0
- makker-0.3.0rc1/tests/test_julia_text.py +62 -0
- makker-0.3.0rc1/tests/test_julia_threads.py +114 -0
- makker-0.3.0rc1/tests/test_juliakernel.py +427 -0
- makker-0.3.0rc1/tests/test_kernel_robustness.py +87 -0
- makker-0.3.0rc1/tests/test_lab.py +100 -0
- makker-0.3.0rc1/tests/test_legacy.py +350 -0
- makker-0.3.0rc1/tests/test_markdown_render.py +78 -0
- makker-0.3.0rc1/tests/test_memory.py +128 -0
- makker-0.3.0rc1/tests/test_messages.py +35 -0
- makker-0.3.0rc1/tests/test_model_menu.py +213 -0
- makker-0.3.0rc1/tests/test_models.py +275 -0
- makker-0.3.0rc1/tests/test_ollama_client.py +183 -0
- makker-0.3.0rc1/tests/test_openai_responses.py +72 -0
- makker-0.3.0rc1/tests/test_openrouter.py +100 -0
- makker-0.3.0rc1/tests/test_paths.py +93 -0
- makker-0.3.0rc1/tests/test_plot_julia_src.py +427 -0
- makker-0.3.0rc1/tests/test_plot_web.py +502 -0
- makker-0.3.0rc1/tests/test_prompts.py +73 -0
- makker-0.3.0rc1/tests/test_recent_models.py +42 -0
- makker-0.3.0rc1/tests/test_recorder.py +175 -0
- makker-0.3.0rc1/tests/test_recovery.py +127 -0
- makker-0.3.0rc1/tests/test_registry.py +115 -0
- makker-0.3.0rc1/tests/test_report_renderer.py +401 -0
- makker-0.3.0rc1/tests/test_reset_julia.py +112 -0
- makker-0.3.0rc1/tests/test_review.py +529 -0
- makker-0.3.0rc1/tests/test_server_access.py +138 -0
- makker-0.3.0rc1/tests/test_server_session.py +2513 -0
- makker-0.3.0rc1/tests/test_server_updates.py +584 -0
- makker-0.3.0rc1/tests/test_session_host_driver.py +84 -0
- makker-0.3.0rc1/tests/test_session_layout.py +308 -0
- makker-0.3.0rc1/tests/test_simulators_smoke.py +126 -0
- makker-0.3.0rc1/tests/test_skills_and_prompt.py +147 -0
- makker-0.3.0rc1/tests/test_smoke.py +167 -0
- makker-0.3.0rc1/tests/test_summarization.py +96 -0
- makker-0.3.0rc1/tests/test_sysimage.py +434 -0
- makker-0.3.0rc1/tests/test_sysimage_build.py +944 -0
- makker-0.3.0rc1/tests/test_sysimage_integration.py +164 -0
- makker-0.3.0rc1/tests/test_titling.py +52 -0
- makker-0.3.0rc1/tests/test_tool_display.py +251 -0
- makker-0.3.0rc1/tests/test_tool_eviction.py +58 -0
- makker-0.3.0rc1/tests/test_tool_output.py +47 -0
- makker-0.3.0rc1/tests/test_tools_julia_plot.py +414 -0
- makker-0.3.0rc1/tests/test_trace.py +61 -0
- makker-0.3.0rc1/tests/test_trace_schema.py +54 -0
- makker-0.3.0rc1/tests/test_transcript.py +84 -0
- makker-0.3.0rc1/tests/test_transcript_html.py +396 -0
- makker-0.3.0rc1/tests/test_turns.py +308 -0
- makker-0.3.0rc1/tests/test_update_check.py +192 -0
- makker-0.3.0rc1/tests/test_update_helper.py +217 -0
- makker-0.3.0rc1/tests/test_user_config.py +36 -0
- makker-0.3.0rc1/tests/test_warm_source_refresh.py +139 -0
- makker-0.3.0rc1/tests/test_warmup.py +326 -0
- makker-0.3.0rc1/tests/test_warmup_package.py +143 -0
- makker-0.3.0rc1/tests/test_web_serving.py +139 -0
- makker-0.3.0rc1/tests/test_widgets.py +186 -0
- makker-0.3.0rc1/tests/test_windows_paths.py +134 -0
- makker-0.3.0rc1/tests/test_wire_protocol.py +296 -0
- makker-0.3.0rc1/tests/test_workspace.py +765 -0
- makker-0.3.0rc1/tests/test_workspace_backend.py +185 -0
- makker-0.3.0rc1/tests/tui_captures/tui/answer.txt +32 -0
- makker-0.3.0rc1/tests/tui_captures/tui/approval.txt +32 -0
- makker-0.3.0rc1/tests/tui_captures/tui/approval_resolved.txt +32 -0
- makker-0.3.0rc1/tests/tui_captures/tui/empty_answer.txt +32 -0
- makker-0.3.0rc1/tests/tui_captures/tui/long_output.txt +32 -0
- makker-0.3.0rc1/tests/tui_captures/tui/multi_turn.txt +32 -0
- makker-0.3.0rc1/tests/tui_captures/tui/narrow.txt +24 -0
- makker-0.3.0rc1/tests/tui_captures/tui/reasoning.txt +32 -0
- makker-0.3.0rc1/tests/tui_captures/tui/streaming.txt +32 -0
- makker-0.3.0rc1/tests/tui_captures/tui/tool_call.txt +32 -0
- makker-0.3.0rc1/tests/tui_captures/tui/tool_error.txt +32 -0
- makker-0.3.0rc1/tests/tui_captures/tui/unicode_output.txt +32 -0
- makker-0.3.0rc1/tests/tui_captures/tui/welcome.txt +32 -0
- makker-0.3.0rc1/tests/tui_captures/tui/wide_line.txt +32 -0
- makker-0.3.0rc1/tests/upgrade/check_upgrade.py +262 -0
|
@@ -0,0 +1,55 @@
|
|
|
1
|
+
# Python
|
|
2
|
+
__pycache__/
|
|
3
|
+
*.py[cod]
|
|
4
|
+
*.egg-info/
|
|
5
|
+
.venv/
|
|
6
|
+
.pytest_cache/
|
|
7
|
+
.ruff_cache/
|
|
8
|
+
.mypy_cache/
|
|
9
|
+
dist/
|
|
10
|
+
build/
|
|
11
|
+
|
|
12
|
+
# uv.lock is committed for reproducible installs (see [tool.uv] in pyproject.toml).
|
|
13
|
+
|
|
14
|
+
# Generated by hatch-vcs at build time from the latest git tag (see pyproject.toml).
|
|
15
|
+
src/makker/_version.py
|
|
16
|
+
|
|
17
|
+
# Secrets and local editor config
|
|
18
|
+
.env
|
|
19
|
+
.env.*
|
|
20
|
+
!.env.example
|
|
21
|
+
.mcp.json
|
|
22
|
+
|
|
23
|
+
# Project state
|
|
24
|
+
.makker/
|
|
25
|
+
.jutul-agent/
|
|
26
|
+
|
|
27
|
+
# Julia lockfiles
|
|
28
|
+
src/makker/**/Manifest.toml
|
|
29
|
+
|
|
30
|
+
# The shared Makker package synced into a sim env template for in-place
|
|
31
|
+
# instantiate (CI/tests). The canonical source lives in julia_runtime/ and the
|
|
32
|
+
# per-sim Makker<Sim> packages are tracked; only these synced copies are not.
|
|
33
|
+
src/makker/simulators/*/julia_env/Makker/
|
|
34
|
+
|
|
35
|
+
# IDE
|
|
36
|
+
.vscode/
|
|
37
|
+
.idea/
|
|
38
|
+
|
|
39
|
+
# Claude Code: share project commands, keep local settings/worktrees out.
|
|
40
|
+
.claude/*
|
|
41
|
+
!.claude/commands/
|
|
42
|
+
.claude/settings.local.json
|
|
43
|
+
|
|
44
|
+
# Scratch findings the `/review-mine` command writes before ingesting.
|
|
45
|
+
.makker-review/
|
|
46
|
+
|
|
47
|
+
# OS
|
|
48
|
+
.DS_Store
|
|
49
|
+
Thumbs.db
|
|
50
|
+
site/
|
|
51
|
+
|
|
52
|
+
# Local scratch / lab output
|
|
53
|
+
.makker-review/
|
|
54
|
+
lab-out/
|
|
55
|
+
testbed/
|
|
@@ -0,0 +1,190 @@
|
|
|
1
|
+
# Makker
|
|
2
|
+
|
|
3
|
+
## Purpose
|
|
4
|
+
|
|
5
|
+
Makker is an AI agent for computational science, built on Deep Agents.
|
|
6
|
+
Simulators plug in as adapters. The ones it ships with today come from the Jutul
|
|
7
|
+
ecosystem and run in Julia.
|
|
8
|
+
|
|
9
|
+
## Working rules
|
|
10
|
+
|
|
11
|
+
- Prefer the live Julia session and simulator source code over model memory.
|
|
12
|
+
- Use the persistent Julia REPL incrementally. Run the smallest useful probe
|
|
13
|
+
first, inspect the result, then extend.
|
|
14
|
+
- Treat the installed simulator packages as the source of truth for APIs and
|
|
15
|
+
examples.
|
|
16
|
+
- Keep Julia execution serialized unless the runtime explicitly supports
|
|
17
|
+
concurrency.
|
|
18
|
+
- Reuse a prepared Julia environment when its simulator and dependencies match;
|
|
19
|
+
pass it with `--julia-project` instead of setting up a new env for each task.
|
|
20
|
+
Refresh it when dependencies or the bundled Julia runtime change.
|
|
21
|
+
- Prefer Deep Agents memory and skills for reusable guidance; keep custom
|
|
22
|
+
Python focused on Julia execution, simulator inspection, and trace capture.
|
|
23
|
+
|
|
24
|
+
## Validation
|
|
25
|
+
|
|
26
|
+
- Default suite (no Julia): `uv run pytest -q -m "not integration"`
|
|
27
|
+
- Integration suite (requires Julia + an instantiated env): `uv run pytest -q -m integration`.
|
|
28
|
+
Envs instantiate from `Project.toml` + `[sources]`.
|
|
29
|
+
`tests/test_simulators_smoke.py` loads each simulator with `using <Sim>`.
|
|
30
|
+
- Live LLM (humans only, needs API key): `uv run pytest tests/live/`
|
|
31
|
+
- Update transcript / report snapshots after renderer changes:
|
|
32
|
+
`uv run pytest --snapshot-update tests/test_transcript_html.py tests/test_transcript.py tests/test_report_renderer.py`
|
|
33
|
+
- Python style (matches CI): `uv run ruff check .` then `uv run ruff format .`
|
|
34
|
+
- After editing Python, run `uv run ruff format` on touched paths (or rely on
|
|
35
|
+
format-on-save / pre-commit if installed).
|
|
36
|
+
- Web UI (React + TypeScript in `interfaces/server/webapp`): `npm install`, then
|
|
37
|
+
`npm test` (vitest) and `npm run typecheck`. It ships **pre-built** — after any
|
|
38
|
+
change under `webapp/src`, run `npm run build` and commit the regenerated
|
|
39
|
+
`interfaces/server/web_dist`. That committed bundle is what the server serves,
|
|
40
|
+
so end users install with `uv`/`pip` and never need Node.
|
|
41
|
+
|
|
42
|
+
## Continuous integration
|
|
43
|
+
|
|
44
|
+
GitHub Actions workflows:
|
|
45
|
+
|
|
46
|
+
- `ci.yml`: every push/PR. `lint` (ruff); `test` across Linux/Windows/macOS
|
|
47
|
+
on Python 3.12, plus Linux on 3.14, the newest Python `uv tool install` tends
|
|
48
|
+
to pick (`pytest -m "not integration" -n 2 --dist loadfile`, no Julia).
|
|
49
|
+
- `simulators.yml`: runs JuliaKernel and all four simulator integration jobs
|
|
50
|
+
on every PR and push to `main`, plus weekly Monday and manual runs. The
|
|
51
|
+
JutulDarcy smoke job also runs real plot tests. Each smoke job instantiates
|
|
52
|
+
its env from current upstream, precompiles, and runs `test_simulators_smoke.py`.
|
|
53
|
+
Depots are cached by Julia version, simulator, resolved dependencies, and Julia
|
|
54
|
+
source; no Manifests are cached or committed for CI.
|
|
55
|
+
- `deps-canary.yml`: weekly and manual only. Resolves the newest stack,
|
|
56
|
+
ignoring the pin, and reports to the run summary without ever marking a
|
|
57
|
+
commit red. It is the early warning for when the pin can move.
|
|
58
|
+
- `docs.yml`: builds the MkDocs site on changes under `docs/`, publishing on
|
|
59
|
+
`main`.
|
|
60
|
+
- `release.yml`: on a published GitHub release tagged `vX.Y.Z`, builds and
|
|
61
|
+
uploads to PyPI. The tag is the only source of the version.
|
|
62
|
+
- `upgrade.yml`: every push/PR, temporary. Installs a released jutul-agent,
|
|
63
|
+
updates it to this checkout (`tests/upgrade/check_upgrade.py`), and checks the
|
|
64
|
+
data folder and workspace came along, on Linux, macOS and Windows.
|
|
65
|
+
- `release-bridge.yml`: manual, run from a release tag. Publishes the last
|
|
66
|
+
release of the old package, jutul-agent (`bridge/jutul-agent`), which installs
|
|
67
|
+
Makker and starts it so existing installs move across on their next update.
|
|
68
|
+
|
|
69
|
+
## Local git hooks
|
|
70
|
+
|
|
71
|
+
One-time per clone: `uv run pre-commit install`. Commits then run Ruff format
|
|
72
|
+
and check on staged `.py` files. To verify the whole tree like CI:
|
|
73
|
+
`uv run pre-commit run --all-files`.
|
|
74
|
+
|
|
75
|
+
## Important paths
|
|
76
|
+
|
|
77
|
+
- `src/makker/paths.py`: the three runtime anchors (`PACKAGE_ROOT`
|
|
78
|
+
(install), `workspace_root()` (CWD), `state_home()` (sessions)) and the path
|
|
79
|
+
policy (`resolve_in_workspace`, `is_host_path`), the one place that maps
|
|
80
|
+
agent-visible paths to real files.
|
|
81
|
+
- `src/makker/workspace.py`: workspace config
|
|
82
|
+
(`.makker/config.toml`), simulator auto-detect, Julia-env bootstrap.
|
|
83
|
+
- `src/makker/session.py`: `Session`, the unit of work for one
|
|
84
|
+
invocation.
|
|
85
|
+
- `src/makker/models.py`: provider metadata and the model catalog
|
|
86
|
+
discovery. `src/makker/display.py`: display detection and Xvfb
|
|
87
|
+
management for headless plotting.
|
|
88
|
+
- `src/makker/agent/builder.py`: deepagents wiring (composite backend,
|
|
89
|
+
HarnessProfile registration, `build_agent` entry point). Custom tools sit
|
|
90
|
+
alongside (`tools.py`, `plot_julia.py`, `memory.py`, `approval.py`,
|
|
91
|
+
`turns.py`, and `added_dirs.py`, which records `/add-dir` folders);
|
|
92
|
+
`tool_labels.py` holds the one friendly name per tool shared by the TUI,
|
|
93
|
+
approval prompt, and transcript. The Julia-side plot capture lives in the
|
|
94
|
+
`julia_runtime/Makker` package. The full system prompt is assembled in
|
|
95
|
+
`prompts.py` (each rule stated once).
|
|
96
|
+
- `src/makker/simulators/`: adapter dataclass, registry, env bootstrap +
|
|
97
|
+
launch-time preparation (`env_setup.prepare_workspace_env`), shared skills,
|
|
98
|
+
and one folder per simulator (see below).
|
|
99
|
+
- `src/makker/julia/`: the `JuliaSession` Protocol (`session.py`) and the
|
|
100
|
+
Julia toolchain checks (`requirements.py`).
|
|
101
|
+
- `src/makker/juliakernel/`: the backend, a self-contained, supervised
|
|
102
|
+
Julia runtime (`kernel.py` + stdlib-only `server.jl`) with live output and
|
|
103
|
+
SIGINT interrupt. Splittable into a standalone package.
|
|
104
|
+
- `src/makker/trace/`: SQLite event log and `TraceRecorder` middleware.
|
|
105
|
+
- `src/makker/transcript/`: renderers that consume a trace
|
|
106
|
+
(HTML transcript, markdown transcript, investigation report).
|
|
107
|
+
- `src/makker/approval_preview.py`: the approval card body every surface
|
|
108
|
+
renders for a pending tool call.
|
|
109
|
+
- `src/makker/session_host.py`: the one session bootstrap and turn-policy
|
|
110
|
+
loop behind every front end.
|
|
111
|
+
- `src/makker/interfaces/`: `cli`, the Textual `tui`, and the `server`
|
|
112
|
+
(FastAPI REST + per-session WebSocket). The browser UI is a React + TypeScript
|
|
113
|
+
app in `server/webapp/` (see its README), built into `server/web_dist/`
|
|
114
|
+
(committed and shipped, so an install needs no Node). `server/updates.py`
|
|
115
|
+
runs an update started from the browser: `uv tool upgrade`, the env step of
|
|
116
|
+
`makker upgrade`, then a restart of the server into the new version.
|
|
117
|
+
- `src/makker/legacy.py`: temporary. Everything that carries a jutul-agent
|
|
118
|
+
install over (data folder, workspace folder, Julia env, old output folders),
|
|
119
|
+
called from a few marked places. `bridge/` and `scripts/rename_to_makker.py`
|
|
120
|
+
belong to the same transition.
|
|
121
|
+
- `tests/`: end-to-end, chat, CLI, and tool coverage. `tests/integration/`
|
|
122
|
+
needs Julia; `tests/live/` needs an LLM provider key.
|
|
123
|
+
|
|
124
|
+
## Per-simulator layout
|
|
125
|
+
|
|
126
|
+
Each simulator lives under `src/makker/simulators/<name>/` and owns
|
|
127
|
+
exactly three things:
|
|
128
|
+
|
|
129
|
+
- `adapter.py`: constructs the `SimulatorAdapter`. Set
|
|
130
|
+
`module_dir = Path(__file__).resolve().parent` so the base class can
|
|
131
|
+
derive `julia_env_template_path` and `skills_dir`.
|
|
132
|
+
- `julia_env/`: `Project.toml` declaring the deps the agent can `using`, plus a
|
|
133
|
+
per-simulator `Makker<Sim>/` warm package (a local `[sources]` path dep whose
|
|
134
|
+
`@recompile_invalidations` + `@compile_workload` bakes that simulator's
|
|
135
|
+
GLMakie-aware solve/plot into the precompile cache, so the first solve is fast).
|
|
136
|
+
The shared, sim-agnostic `Makker` package (figure capture, ensemble helpers,
|
|
137
|
+
generic-Makie warm-up) has a single source in `src/makker/julia_runtime/` and
|
|
138
|
+
is copied into the env at bootstrap (also a relative `[sources]` dep). The
|
|
139
|
+
`Manifest.toml` is generated on instantiate (gitignored). The whole `julia_env/`
|
|
140
|
+
folder is copied into a workspace on bootstrap, so the relative `[sources]` paths
|
|
141
|
+
keep resolving.
|
|
142
|
+
- `skills/<skill-name>/SKILL.md`: markdown skills surfaced via the
|
|
143
|
+
deep-agents skill system.
|
|
144
|
+
|
|
145
|
+
Add a simulator by creating that folder and one entry in
|
|
146
|
+
`simulators/registry.py`. Custom subagent factories, when they land, go on
|
|
147
|
+
the adapter's `subagent_factories` tuple.
|
|
148
|
+
|
|
149
|
+
## deepagents / langgraph private-surface contacts
|
|
150
|
+
|
|
151
|
+
We pin deepagents (see `[tool.uv] exclude-newer` in `pyproject.toml`) and
|
|
152
|
+
touch a few non-public surfaces. `tests/test_deepagents_canaries.py` asserts
|
|
153
|
+
each one still exists, so a bump fails at test time rather than degrading
|
|
154
|
+
silently at runtime. The contacts:
|
|
155
|
+
|
|
156
|
+
- `agent/tools.py`: reads `langgraph.pregel._tools._tool_call_writer`
|
|
157
|
+
(ContextVar) to stream live Julia output as tool-output deltas.
|
|
158
|
+
Import-guarded: if it moves, streaming silently disables.
|
|
159
|
+
- `agent/turns.py` + `makker/lab/fakes.py`: consume the v3
|
|
160
|
+
`astream_events` typed projections (`run.messages` / `run.tool_calls` /
|
|
161
|
+
`run.interrupts` / `run.output`); the fakes mirror that shape, so a
|
|
162
|
+
projection change shows up as test failures.
|
|
163
|
+
- `agent/summarization.py`: manual `/compact` composes the summarization
|
|
164
|
+
middleware's private engine methods. Guarded by a `hasattr` sweep that
|
|
165
|
+
degrades to a clear "unavailable" message.
|
|
166
|
+
- `agent/openrouter.py`: overrides `ChatOpenRouter._create_message_dicts` to
|
|
167
|
+
serialize canonical tool images until upstream supports them. Tests exercise
|
|
168
|
+
the real SDK with mocked HTTP for ordinary and streaming requests.
|
|
169
|
+
- `agent/backend.py`: subclasses `CompositeBackend` (overriding `grep`/`glob`
|
|
170
|
+
so patterns recurse) and `LocalShellBackend` (overriding `write`/`edit`/
|
|
171
|
+
`delete`/`execute` to refuse depot writes, reading `cwd` to resolve relative
|
|
172
|
+
paths). A subclass breaks loudly if a base method's signature moves, but a
|
|
173
|
+
narrowed override degrades quietly, which is why the search overrides
|
|
174
|
+
forward `**kwargs`. After the real-paths refactor nothing routes through a
|
|
175
|
+
mount, so `added_dirs.py` only records the added folders; every tool already
|
|
176
|
+
reaches them by absolute path.
|
|
177
|
+
- `tests/test_builder.py`: imports
|
|
178
|
+
`deepagents.profiles.harness.harness_profiles._harness_profile_for_model`
|
|
179
|
+
to assert our profile resolves for built model instances. It also pins the
|
|
180
|
+
exact tool set the framework installs, since a bump can add or drop one.
|
|
181
|
+
|
|
182
|
+
## WGLMakie private-surface contacts
|
|
183
|
+
|
|
184
|
+
Live web plots render through `julia_runtime/Makker/src/web_views.jl`: a new
|
|
185
|
+
browser connection closes the figure's earlier view and drops WGLMakie's cached
|
|
186
|
+
render data, because WGLMakie 0.13 closes a shared scene when any view closes. It
|
|
187
|
+
calls `WGLMakie.render_with_init` and `delete_wgl_robj!`, reads `Screen.session`,
|
|
188
|
+
and deletes the `:glyph_data` plot attribute. It runs on WGLMakie 0.13.13 up to
|
|
189
|
+
0.14 and falls back to `WithConfig` elsewhere; `tests/integration/web_views.jl`
|
|
190
|
+
asserts CI's resolved version is in that range.
|
makker-0.3.0rc1/LICENSE
ADDED
|
@@ -0,0 +1,21 @@
|
|
|
1
|
+
MIT License
|
|
2
|
+
|
|
3
|
+
Copyright (c) 2026 SINTEF
|
|
4
|
+
|
|
5
|
+
Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
6
|
+
of this software and associated documentation files (the "Software"), to deal
|
|
7
|
+
in the Software without restriction, including without limitation the rights
|
|
8
|
+
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|
9
|
+
copies of the Software, and to permit persons to whom the Software is
|
|
10
|
+
furnished to do so, subject to the following conditions:
|
|
11
|
+
|
|
12
|
+
The above copyright notice and this permission notice shall be included in all
|
|
13
|
+
copies or substantial portions of the Software.
|
|
14
|
+
|
|
15
|
+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
16
|
+
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
17
|
+
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
18
|
+
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
19
|
+
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
20
|
+
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
|
21
|
+
SOFTWARE.
|
makker-0.3.0rc1/PKG-INFO
ADDED
|
@@ -0,0 +1,157 @@
|
|
|
1
|
+
Metadata-Version: 2.5
|
|
2
|
+
Name: makker
|
|
3
|
+
Version: 0.3.0rc1
|
|
4
|
+
Summary: An AI agent for computational science: it plans, runs and analyses simulation studies, on its own or alongside you.
|
|
5
|
+
Project-URL: Homepage, https://github.com/SINTEF-agentlab/makker
|
|
6
|
+
Project-URL: Documentation, https://sintef-agentlab.github.io/makker/
|
|
7
|
+
Project-URL: Repository, https://github.com/SINTEF-agentlab/makker
|
|
8
|
+
Project-URL: Issues, https://github.com/SINTEF-agentlab/makker/issues
|
|
9
|
+
Author-email: Jakob Torben <jakob.torben@sintef.no>
|
|
10
|
+
License-Expression: MIT
|
|
11
|
+
License-File: LICENSE
|
|
12
|
+
Classifier: Development Status :: 3 - Alpha
|
|
13
|
+
Classifier: Intended Audience :: Science/Research
|
|
14
|
+
Classifier: Programming Language :: Python :: 3
|
|
15
|
+
Classifier: Programming Language :: Python :: 3.12
|
|
16
|
+
Classifier: Programming Language :: Python :: 3.14
|
|
17
|
+
Classifier: Topic :: Scientific/Engineering
|
|
18
|
+
Requires-Python: >=3.12
|
|
19
|
+
Requires-Dist: deepagents>=0.7.26
|
|
20
|
+
Requires-Dist: fastapi>=0.115
|
|
21
|
+
Requires-Dist: httpx>=0.27
|
|
22
|
+
Requires-Dist: langchain-google-genai>=4.2.2
|
|
23
|
+
Requires-Dist: langchain-ollama>=1.1.0
|
|
24
|
+
Requires-Dist: langchain-openai>=0.2
|
|
25
|
+
Requires-Dist: langchain-openrouter>=0.2.9
|
|
26
|
+
Requires-Dist: langgraph-checkpoint-sqlite>=3.1.0
|
|
27
|
+
Requires-Dist: markdown-it-py[linkify]>=4.0
|
|
28
|
+
Requires-Dist: pillow>=12.2.0
|
|
29
|
+
Requires-Dist: pygments>=2.17
|
|
30
|
+
Requires-Dist: python-dotenv>=1.0
|
|
31
|
+
Requires-Dist: python-multipart>=0.0.9
|
|
32
|
+
Requires-Dist: textual>=8.2.6
|
|
33
|
+
Requires-Dist: tomli-w>=1.2.0
|
|
34
|
+
Requires-Dist: uvicorn[standard]>=0.30
|
|
35
|
+
Requires-Dist: websockets>=13
|
|
36
|
+
Provides-Extra: eval
|
|
37
|
+
Requires-Dist: anthropic>=1.0.0; extra == 'eval'
|
|
38
|
+
Requires-Dist: inspect-ai<0.4,>=0.3.263; extra == 'eval'
|
|
39
|
+
Requires-Dist: openai>=3.1.0; extra == 'eval'
|
|
40
|
+
Description-Content-Type: text/markdown
|
|
41
|
+
|
|
42
|
+
# Makker
|
|
43
|
+
|
|
44
|
+
[](https://github.com/SINTEF-agentlab/makker/actions/workflows/ci.yml)
|
|
45
|
+
[](https://github.com/SINTEF-agentlab/makker/actions/workflows/simulators.yml)
|
|
46
|
+
[](https://sintef-agentlab.github.io/makker/)
|
|
47
|
+
[](https://pypi.org/project/makker/)
|
|
48
|
+
[](LICENSE)
|
|
49
|
+
|
|
50
|
+
An AI agent for computational science. Give Makker a question and it plans the
|
|
51
|
+
study, sets up and runs the simulations, analyses and plots the results, and
|
|
52
|
+
decides what to try next. It can carry an investigation on its own or work
|
|
53
|
+
through it with you, and it records every step so the result can be checked.
|
|
54
|
+
|
|
55
|
+
*Makker* (MAHK-er) is Norwegian for the partner you do a job with. The project
|
|
56
|
+
was formerly called jutul-agent.
|
|
57
|
+
|
|
58
|
+
Makker works across simulators and fields of science. The ones below come ready
|
|
59
|
+
to use, and you can
|
|
60
|
+
[add your own](https://sintef-agentlab.github.io/makker/extending-for-your-application/).
|
|
61
|
+
|
|
62
|
+
<p align="center">
|
|
63
|
+
<a href="https://github.com/sintefmath/JutulDarcy.jl"><img src="https://raw.githubusercontent.com/sintefmath/JutulDarcy.jl/main/docs/src/assets/logo_wide.png" alt="JutulDarcy" height="42"></a>
|
|
64
|
+
<a href="https://github.com/BattMoTeam/BattMo.jl"><img src="https://raw.githubusercontent.com/BattMoTeam/BattMo.jl/main/docs/src/assets/battmologo_text.png" alt="BattMo" height="74"></a>
|
|
65
|
+
<a href="https://github.com/sintefmath/Fimbul.jl"><img src="https://raw.githubusercontent.com/sintefmath/Fimbul.jl/main/docs/src/assets/logo_text_wide.png" alt="Fimbul" height="50"></a>
|
|
66
|
+
<a href="https://github.com/sintefmath/Mocca.jl"><img src="https://raw.githubusercontent.com/sintefmath/Mocca.jl/main/docs/src/assets/mocca_small_transparent.png" alt="Mocca" height="62"></a>
|
|
67
|
+
</p>
|
|
68
|
+
|
|
69
|
+
<p align="center">
|
|
70
|
+
<img src="docs/images/web-fimbul.png" alt="Makker web UI: a Fimbul geothermal doublet with the 3D temperature field over time" width="47%">
|
|
71
|
+
|
|
72
|
+
<img src="docs/images/web-battmo.png" alt="Makker web UI: a BattMo discharge-rate investigation with plots and a report" width="47%">
|
|
73
|
+
</p>
|
|
74
|
+
<p align="center"><sub>The web UI (<code>makker</code>): chat on the left; interactive plots and reports pinned in a canvas on the right. On the left, a Fimbul geothermal doublet showing the 3D temperature field around the wells over time. On the right, a BattMo C-rate study with voltage curves, an attempts map, and a written report.</sub></p>
|
|
75
|
+
|
|
76
|
+
## Quickstart
|
|
77
|
+
|
|
78
|
+
Install [uv](https://docs.astral.sh/uv/getting-started/installation/) and Julia
|
|
79
|
+
(via [juliaup](https://github.com/JuliaLang/juliaup)). Then:
|
|
80
|
+
|
|
81
|
+
```sh
|
|
82
|
+
uv tool install makker
|
|
83
|
+
makker key openai # save a key (Anthropic, Google, and OpenRouter work too)
|
|
84
|
+
|
|
85
|
+
mkdir my-study && cd my-study
|
|
86
|
+
makker init --sim battmo # jutuldarcy | battmo | fimbul | mocca
|
|
87
|
+
makker # start the web UI (or: makker tui)
|
|
88
|
+
```
|
|
89
|
+
|
|
90
|
+
Local models through [Ollama](https://ollama.com) need no key. `init`
|
|
91
|
+
precompiles the Julia and plotting stacks once (a few minutes), so sessions
|
|
92
|
+
then start in seconds, and `makker doctor` checks the setup if anything
|
|
93
|
+
looks wrong. Keep it current with `makker upgrade`.
|
|
94
|
+
|
|
95
|
+
One folder is bound to one simulator and its Julia environment, so use a
|
|
96
|
+
separate folder for each. `makker` with no command serves the web UI at
|
|
97
|
+
<http://127.0.0.1:8742>, locally for a single trusted user; `makker tui`
|
|
98
|
+
is the terminal alternative. The full [installation and usage
|
|
99
|
+
guide](https://sintef-agentlab.github.io/makker/usage/) covers workspaces,
|
|
100
|
+
interfaces, and models; to work on Makker itself, clone the repo (see
|
|
101
|
+
[Development](#development)).
|
|
102
|
+
|
|
103
|
+
## Supported simulators
|
|
104
|
+
|
|
105
|
+
| `--sim` | Package | Domain |
|
|
106
|
+
|---|---|---|
|
|
107
|
+
| `jutuldarcy` | [JutulDarcy.jl](https://github.com/sintefmath/JutulDarcy.jl) | Reservoir / multi-phase flow |
|
|
108
|
+
| `battmo` | [BattMo.jl](https://github.com/BattMoTeam/BattMo.jl) | Lithium-ion (and other) battery cells |
|
|
109
|
+
| `fimbul` | [Fimbul.jl](https://github.com/sintefmath/Fimbul.jl) | Geothermal (ATES, BTES, doublet, EGS) |
|
|
110
|
+
| `mocca` | [Mocca.jl](https://github.com/sintefmath/Mocca.jl) | Adsorption-based CO₂ capture (PSA / VSA / TSA) |
|
|
111
|
+
|
|
112
|
+
## What makes it work for scientific computing
|
|
113
|
+
|
|
114
|
+
- A persistent Julia REPL per session. State, loaded packages, and compiled
|
|
115
|
+
methods carry across turns, and a first solve is fast because each
|
|
116
|
+
simulator ships a precompiled warm package.
|
|
117
|
+
- The agent reads real source. Every package in the environment is on disk at
|
|
118
|
+
its real `pkgdir` path (read-only in the shared depot), so answers come from
|
|
119
|
+
the installed version, not from memory.
|
|
120
|
+
- Everything is recorded. Each session writes a trace of every message, tool
|
|
121
|
+
call, and artifact. Transcripts and the benchmark grade against it.
|
|
122
|
+
- Models are interchangeable: OpenAI, Anthropic, Google, OpenRouter, or local models via
|
|
123
|
+
Ollama, switchable mid-session.
|
|
124
|
+
- Where the packages are fixed, such as a demo or a shared machine,
|
|
125
|
+
`init --sysimage` bakes the whole Julia environment into a [system
|
|
126
|
+
image](https://sintef-agentlab.github.io/makker/sysimage/) and sessions
|
|
127
|
+
start with it already loaded. It is checked against the environment before
|
|
128
|
+
every session, so an image that has fallen behind refuses to run instead of
|
|
129
|
+
quietly using the old code.
|
|
130
|
+
|
|
131
|
+
## Documentation
|
|
132
|
+
|
|
133
|
+
The full documentation lives at
|
|
134
|
+
[sintef-agentlab.github.io/makker](https://sintef-agentlab.github.io/makker/)
|
|
135
|
+
(source in [docs/](docs/)): using the agent, how it works (architecture,
|
|
136
|
+
the Julia kernel, the trace), and extending it (adding a simulator,
|
|
137
|
+
improving the agent, evaluation).
|
|
138
|
+
|
|
139
|
+
## Development
|
|
140
|
+
|
|
141
|
+
Work from a clone instead of a tool install. `uv run` resolves the
|
|
142
|
+
`makker` command from the checkout, so run every command through it
|
|
143
|
+
(`uv run makker ...`); upgrade with `git pull && uv sync`.
|
|
144
|
+
|
|
145
|
+
```sh
|
|
146
|
+
git clone https://github.com/SINTEF-agentlab/makker
|
|
147
|
+
cd makker
|
|
148
|
+
uv sync --extra eval
|
|
149
|
+
uv run pre-commit install
|
|
150
|
+
|
|
151
|
+
uv run ruff check . # lint
|
|
152
|
+
uv run pytest # unit tests (integration and live skipped)
|
|
153
|
+
uv run pytest -m integration # adds the Julia-requiring tests
|
|
154
|
+
uv run makker eval canary # bench canary
|
|
155
|
+
```
|
|
156
|
+
|
|
157
|
+
Developed at [SINTEF](https://www.sintef.no/en/).
|
|
@@ -0,0 +1,116 @@
|
|
|
1
|
+
# Makker
|
|
2
|
+
|
|
3
|
+
[](https://github.com/SINTEF-agentlab/makker/actions/workflows/ci.yml)
|
|
4
|
+
[](https://github.com/SINTEF-agentlab/makker/actions/workflows/simulators.yml)
|
|
5
|
+
[](https://sintef-agentlab.github.io/makker/)
|
|
6
|
+
[](https://pypi.org/project/makker/)
|
|
7
|
+
[](LICENSE)
|
|
8
|
+
|
|
9
|
+
An AI agent for computational science. Give Makker a question and it plans the
|
|
10
|
+
study, sets up and runs the simulations, analyses and plots the results, and
|
|
11
|
+
decides what to try next. It can carry an investigation on its own or work
|
|
12
|
+
through it with you, and it records every step so the result can be checked.
|
|
13
|
+
|
|
14
|
+
*Makker* (MAHK-er) is Norwegian for the partner you do a job with. The project
|
|
15
|
+
was formerly called jutul-agent.
|
|
16
|
+
|
|
17
|
+
Makker works across simulators and fields of science. The ones below come ready
|
|
18
|
+
to use, and you can
|
|
19
|
+
[add your own](https://sintef-agentlab.github.io/makker/extending-for-your-application/).
|
|
20
|
+
|
|
21
|
+
<p align="center">
|
|
22
|
+
<a href="https://github.com/sintefmath/JutulDarcy.jl"><img src="https://raw.githubusercontent.com/sintefmath/JutulDarcy.jl/main/docs/src/assets/logo_wide.png" alt="JutulDarcy" height="42"></a>
|
|
23
|
+
<a href="https://github.com/BattMoTeam/BattMo.jl"><img src="https://raw.githubusercontent.com/BattMoTeam/BattMo.jl/main/docs/src/assets/battmologo_text.png" alt="BattMo" height="74"></a>
|
|
24
|
+
<a href="https://github.com/sintefmath/Fimbul.jl"><img src="https://raw.githubusercontent.com/sintefmath/Fimbul.jl/main/docs/src/assets/logo_text_wide.png" alt="Fimbul" height="50"></a>
|
|
25
|
+
<a href="https://github.com/sintefmath/Mocca.jl"><img src="https://raw.githubusercontent.com/sintefmath/Mocca.jl/main/docs/src/assets/mocca_small_transparent.png" alt="Mocca" height="62"></a>
|
|
26
|
+
</p>
|
|
27
|
+
|
|
28
|
+
<p align="center">
|
|
29
|
+
<img src="docs/images/web-fimbul.png" alt="Makker web UI: a Fimbul geothermal doublet with the 3D temperature field over time" width="47%">
|
|
30
|
+
|
|
31
|
+
<img src="docs/images/web-battmo.png" alt="Makker web UI: a BattMo discharge-rate investigation with plots and a report" width="47%">
|
|
32
|
+
</p>
|
|
33
|
+
<p align="center"><sub>The web UI (<code>makker</code>): chat on the left; interactive plots and reports pinned in a canvas on the right. On the left, a Fimbul geothermal doublet showing the 3D temperature field around the wells over time. On the right, a BattMo C-rate study with voltage curves, an attempts map, and a written report.</sub></p>
|
|
34
|
+
|
|
35
|
+
## Quickstart
|
|
36
|
+
|
|
37
|
+
Install [uv](https://docs.astral.sh/uv/getting-started/installation/) and Julia
|
|
38
|
+
(via [juliaup](https://github.com/JuliaLang/juliaup)). Then:
|
|
39
|
+
|
|
40
|
+
```sh
|
|
41
|
+
uv tool install makker
|
|
42
|
+
makker key openai # save a key (Anthropic, Google, and OpenRouter work too)
|
|
43
|
+
|
|
44
|
+
mkdir my-study && cd my-study
|
|
45
|
+
makker init --sim battmo # jutuldarcy | battmo | fimbul | mocca
|
|
46
|
+
makker # start the web UI (or: makker tui)
|
|
47
|
+
```
|
|
48
|
+
|
|
49
|
+
Local models through [Ollama](https://ollama.com) need no key. `init`
|
|
50
|
+
precompiles the Julia and plotting stacks once (a few minutes), so sessions
|
|
51
|
+
then start in seconds, and `makker doctor` checks the setup if anything
|
|
52
|
+
looks wrong. Keep it current with `makker upgrade`.
|
|
53
|
+
|
|
54
|
+
One folder is bound to one simulator and its Julia environment, so use a
|
|
55
|
+
separate folder for each. `makker` with no command serves the web UI at
|
|
56
|
+
<http://127.0.0.1:8742>, locally for a single trusted user; `makker tui`
|
|
57
|
+
is the terminal alternative. The full [installation and usage
|
|
58
|
+
guide](https://sintef-agentlab.github.io/makker/usage/) covers workspaces,
|
|
59
|
+
interfaces, and models; to work on Makker itself, clone the repo (see
|
|
60
|
+
[Development](#development)).
|
|
61
|
+
|
|
62
|
+
## Supported simulators
|
|
63
|
+
|
|
64
|
+
| `--sim` | Package | Domain |
|
|
65
|
+
|---|---|---|
|
|
66
|
+
| `jutuldarcy` | [JutulDarcy.jl](https://github.com/sintefmath/JutulDarcy.jl) | Reservoir / multi-phase flow |
|
|
67
|
+
| `battmo` | [BattMo.jl](https://github.com/BattMoTeam/BattMo.jl) | Lithium-ion (and other) battery cells |
|
|
68
|
+
| `fimbul` | [Fimbul.jl](https://github.com/sintefmath/Fimbul.jl) | Geothermal (ATES, BTES, doublet, EGS) |
|
|
69
|
+
| `mocca` | [Mocca.jl](https://github.com/sintefmath/Mocca.jl) | Adsorption-based CO₂ capture (PSA / VSA / TSA) |
|
|
70
|
+
|
|
71
|
+
## What makes it work for scientific computing
|
|
72
|
+
|
|
73
|
+
- A persistent Julia REPL per session. State, loaded packages, and compiled
|
|
74
|
+
methods carry across turns, and a first solve is fast because each
|
|
75
|
+
simulator ships a precompiled warm package.
|
|
76
|
+
- The agent reads real source. Every package in the environment is on disk at
|
|
77
|
+
its real `pkgdir` path (read-only in the shared depot), so answers come from
|
|
78
|
+
the installed version, not from memory.
|
|
79
|
+
- Everything is recorded. Each session writes a trace of every message, tool
|
|
80
|
+
call, and artifact. Transcripts and the benchmark grade against it.
|
|
81
|
+
- Models are interchangeable: OpenAI, Anthropic, Google, OpenRouter, or local models via
|
|
82
|
+
Ollama, switchable mid-session.
|
|
83
|
+
- Where the packages are fixed, such as a demo or a shared machine,
|
|
84
|
+
`init --sysimage` bakes the whole Julia environment into a [system
|
|
85
|
+
image](https://sintef-agentlab.github.io/makker/sysimage/) and sessions
|
|
86
|
+
start with it already loaded. It is checked against the environment before
|
|
87
|
+
every session, so an image that has fallen behind refuses to run instead of
|
|
88
|
+
quietly using the old code.
|
|
89
|
+
|
|
90
|
+
## Documentation
|
|
91
|
+
|
|
92
|
+
The full documentation lives at
|
|
93
|
+
[sintef-agentlab.github.io/makker](https://sintef-agentlab.github.io/makker/)
|
|
94
|
+
(source in [docs/](docs/)): using the agent, how it works (architecture,
|
|
95
|
+
the Julia kernel, the trace), and extending it (adding a simulator,
|
|
96
|
+
improving the agent, evaluation).
|
|
97
|
+
|
|
98
|
+
## Development
|
|
99
|
+
|
|
100
|
+
Work from a clone instead of a tool install. `uv run` resolves the
|
|
101
|
+
`makker` command from the checkout, so run every command through it
|
|
102
|
+
(`uv run makker ...`); upgrade with `git pull && uv sync`.
|
|
103
|
+
|
|
104
|
+
```sh
|
|
105
|
+
git clone https://github.com/SINTEF-agentlab/makker
|
|
106
|
+
cd makker
|
|
107
|
+
uv sync --extra eval
|
|
108
|
+
uv run pre-commit install
|
|
109
|
+
|
|
110
|
+
uv run ruff check . # lint
|
|
111
|
+
uv run pytest # unit tests (integration and live skipped)
|
|
112
|
+
uv run pytest -m integration # adds the Julia-requiring tests
|
|
113
|
+
uv run makker eval canary # bench canary
|
|
114
|
+
```
|
|
115
|
+
|
|
116
|
+
Developed at [SINTEF](https://www.sintef.no/en/).
|
|
@@ -0,0 +1,20 @@
|
|
|
1
|
+
# jutul-agent is now Makker
|
|
2
|
+
|
|
3
|
+
jutul-agent has been renamed to [Makker](https://github.com/SINTEF-agentlab/makker),
|
|
4
|
+
an AI agent for computational science. Development continues there, under the
|
|
5
|
+
package name [`makker`](https://pypi.org/project/makker/).
|
|
6
|
+
|
|
7
|
+
## New installs
|
|
8
|
+
|
|
9
|
+
```sh
|
|
10
|
+
uv tool install makker
|
|
11
|
+
```
|
|
12
|
+
|
|
13
|
+
## Existing installs
|
|
14
|
+
|
|
15
|
+
Update as usual, with the Update button in the web UI or with
|
|
16
|
+
`uv tool upgrade jutul-agent`. This release then installs Makker and starts it:
|
|
17
|
+
your API keys, chats and workspaces are carried over, and the command is
|
|
18
|
+
`makker` from then on.
|
|
19
|
+
|
|
20
|
+
This is the last release under the old name.
|
|
@@ -0,0 +1,38 @@
|
|
|
1
|
+
# The last release of jutul-agent. The project is now Makker (the rest of this
|
|
2
|
+
# repository); this package only carries existing installs across. It is built
|
|
3
|
+
# and published by .github/workflows/release-bridge.yml, never by release.yml.
|
|
4
|
+
[project]
|
|
5
|
+
name = "jutul-agent"
|
|
6
|
+
version = "0.3.0rc1"
|
|
7
|
+
description = "jutul-agent is now Makker. This final release installs Makker and starts it."
|
|
8
|
+
readme = "README.md"
|
|
9
|
+
requires-python = ">=3.12"
|
|
10
|
+
authors = [
|
|
11
|
+
{name = "Jakob Torben", email = "jakob.torben@sintef.no"},
|
|
12
|
+
]
|
|
13
|
+
license = "MIT"
|
|
14
|
+
classifiers = [
|
|
15
|
+
"Development Status :: 7 - Inactive",
|
|
16
|
+
"Intended Audience :: Science/Research",
|
|
17
|
+
"Programming Language :: Python :: 3",
|
|
18
|
+
"Topic :: Scientific/Engineering",
|
|
19
|
+
]
|
|
20
|
+
# Keep this the only dependency, and keep it first: the release workflow reads
|
|
21
|
+
# the Makker version it names.
|
|
22
|
+
dependencies = [
|
|
23
|
+
"makker>=0.3.0rc1",
|
|
24
|
+
]
|
|
25
|
+
|
|
26
|
+
[project.urls]
|
|
27
|
+
Homepage = "https://github.com/SINTEF-agentlab/makker"
|
|
28
|
+
Documentation = "https://sintef-agentlab.github.io/makker/"
|
|
29
|
+
|
|
30
|
+
[project.scripts]
|
|
31
|
+
jutul-agent = "jutul_agent.__main__:main"
|
|
32
|
+
|
|
33
|
+
[build-system]
|
|
34
|
+
requires = ["hatchling"]
|
|
35
|
+
build-backend = "hatchling.build"
|
|
36
|
+
|
|
37
|
+
[tool.hatch.build.targets.wheel]
|
|
38
|
+
packages = ["src/jutul_agent"]
|