flowcraft
Production-grade Go SDK for building AI agents with long-term memory, knowledge retrieval, and voice — runnable as a library, a daemon, or a real-time pipeline.
File Explorer
Download Latest Version (.zip)- ci.yml
- release-modules.yml
- actionlint.yaml
- core-init.json
- core-v0.1.1.json
- core-v0.1.10.json
- core-v0.1.11.json
- core-v0.1.12.json
- core-v0.1.13.json
- core-v0.1.14.json
- core-v0.1.15.json
- core-v0.1.16.json
- core-v0.1.17.json
- core-v0.1.18.json
- core-v0.1.19.json
- core-v0.1.2.json
- core-v0.1.20.json
- core-v0.1.21.json
- core-v0.1.22.json
- core-v0.1.23.json
- core-v0.1.24.json
- core-v0.1.25.json
- core-v0.1.26.json
- core-v0.1.3.json
- core-v0.1.4.json
- core-v0.1.5.json
- core-v0.1.6.json
- core-v0.1.7.json
- core-v0.1.8.json
- core-v0.1.9.json
- README.md
- checkpoint.go
- resource.go
- go.mod
- go.sum
- main.go
- 10-hello.yaml
- layer_test.go
- plugin.yaml
- README.md
- main.go
- doc.go
- plugin.go
- provider.go
- provider_e2e_test.go
- stream.go
- doc.go
- jsonrpc.go
- service.go
- service_test.go
- config.go
- config_test.go
- doc.go
- fingerprint.go
- go.mod
- go.sum
- layer_plugin.go
- loader.go
- loader_test.go
- manifest.go
- manifest_test.go
- plugin.go
- README.md
- service_spec.go
- version.go
- version_test.go
- client.go
- contract_test.go
- convert.go
- doc.go
- engine.go
- engine_options.go
- errors.go
- resource.go
- resource_test.go
- after_execute_suite.go
- checkpoint_store_suite.go
- doc.go
- engine_suite.go
- engine_suite_test.go
- hook_suites_test.go
- host_suite.go
- host_suite_test.go
- lifecycle_suites.go
- mock_host.go
- new_suites_test.go
- observer_suite.go
- resumer_suite.go
- script_runtime_suite.go
- stream_sink_suite.go
- suggester_suite.go
- suite_test.go
- bridge_board.go
- bridge_board_test.go
- bridge_expr.go
- bridge_expr_internal_test.go
- bridge_fs.go
- bridge_host.go
- bridge_host_test.go
- bridge_inference.go
- bridge_inference_test.go
- bridge_run.go
- bridge_run_test.go
- bridge_runtime.go
- bridge_shell.go
- bridge_tools.go
- bridge_tools_test.go
- core.go
- core_test.go
- doc.go
- project.go
- resource.go
- resource_test.go
- workspace.go
- workspace_test.go
- bindings_bridge_board_test.go
- bindings_bridge_expr_test.go
- bindings_bridge_fs_test.go
- bindings_bridge_runtime_test.go
- bindings_bridge_shell_test.go
- cleanup_test.go
- contract_test.go
- jsrt.go
- jsrt_test.go
- resource.go
- resource_test.go
- contract_test.go
- luart.go
- luart_test.go
- push.go
- resource.go
- resource_test.go
- doc.go
- resource.go
- resource_test.go
- agent.go
- agent_test.go
- board.go
- board_refs.go
- board_refs_test.go
- board_test.go
- checkpoint.go
- checkpoint_test.go
- close.go
- close_test.go
- commit_view_test.go
- definition.go
- definition_test.go
- doc.go
- engine.go
- engine_test.go
- execute.go
- execute_internal_test.go
- execute_request.go
- execute_test.go
- host.go
- host_test.go
- lifecycle.go
- lifecycle_internal_test.go
- lifecycle_test.go
- middleware.go
- middleware_test.go
- script.go
- script_test.go
- stream.go
- stream_internal_test.go
- subjects.go
- subjects_test.go
- doc.go
- hostwrap.go
- hostwrap_test.go
- resource.go
- resource_test.go
- card.go
- doc.go
- events.go
- events_metrics_test.go
- kanban.go
- kanban_test.go
- metrics.go
- watch.go
- watch_test.go
- delegation.go
- delegation_test.go
- doc.go
- resource.go
- resource_test.go
- delegation.go
- delegation_test.go
- directory.go
- directory_test.go
- doc.go
- host.go
- host_test.go
- resource.go
- resource_test.go
- service.go
- service_test.go
- session.go
- session_provider_test.go
- builder.go
- builder_test.go
- close_internal_test.go
- doc.go
- document.go
- document_test.go
- layers.go
- layers_test.go
- many_deps_test.go
- parse.go
- parse_test.go
- errors.go
- errors_test.go
- http.go
- http_test.go
- retry.go
- retry_test.go
- bus.go
- envelope.go
- envelope_test.go
- memory.go
- memory_bench_test.go
- memory_route_cache_test.go
- memory_test.go
- observer.go
- observer_test.go
- resource.go
- resource_test.go
- router.go
- router_internal_test.go
- router_multibus_test.go
- router_test.go
- subject.go
- subject_test.go
- trace.go
- trace_test.go
- bridge_node.go
- bridge_parallel.go
- bridge_stream.go
- bridge_test.go
- emitter_test.go
- node.go
- node_test.go
- doc.go
- inference.go
- inference_test.go
- register_test.go
- tool.go
- tool_test.go
- node_type.go
- node_type_test.go
- resource.go
- resource_test.go
- analyze.go
- build_test.go
- condition.go
- contract_test.go
- definition.go
- definition_test.go
- doc.go
- execute.go
- execute_test.go
- graph.go
- helpers_test.go
- message.go
- message_test.go
- node.go
- node_span_test.go
- node_stream_test.go
- options.go
- parallel.go
- parallel_test.go
- registry.go
- registry_test.go
- resolve.go
- resolve_test.go
- resume.go
- subjects.go
- subjects_test.go
- telemetry.go
- vars.go
- compiler.go
- concurrent.go
- conformance_test.go
- counter.go
- doc.go
- embed.go
- fake.go
- fake_test.go
- stream.go
- transcribe.go
- unary.go
- doc.go
- errors.go
- policy.go
- resilience.go
- resilience_test.go
- resource.go
- route_test.go
- router.go
- router_embed.go
- router_generate.go
- router_policy.go
- router_transcribe.go
- telemetry.go
- telemetry_test.go
- assembly.go
- assembly_exec_test.go
- decision.go
- doc.go
- embedding.go
- errors.go
- extension.go
- extension_registry.go
- extension_registry_test.go
- generate.go
- generate_driver.go
- generate_input.go
- generate_intent.go
- generate_output.go
- generate_stream.go
- generate_test.go
- internal_helpers.go
- model.go
- model_test.go
- provider.go
- provider_definition.go
- resource.go
- resource_test.go
- stream_source_test.go
- telemetry.go
- telemetry_test.go
- transcribe.go
- transcribe_finish_test.go
- transcribe_stream.go
- transcribe_stream_assembly_test.go
- transcribe_stream_test.go
- usage.go
- contract_test.go
- hook.go
- hook_test.go
- default.gotmpl
- gotmpl.go
- gotmpl_test.go
- assembly.go
- context.go
- doc.go
- document.go
- error.go
- expand_hint_test.go
- memory_test.go
- render.go
- scope.go
- turn.go
- types.go
- audio.go
- audio_test.go
- image.go
- image_test.go
- source.go
- source_test.go
- stream.go
- stream_test.go
- video.go
- doc.go
- message.go
- parts.go
- parts_test.go
- schema.go
- schema_test.go
- stream.go
- stream_test.go
- tool.go
- dag.go
- dag_test.go
- doc.go
- expand.go
- expand_test.go
- input_resolve_test.go
- input_test.go
- loader.go
- loader_test.go
- registry.go
- registry_test.go
- scalar.go
- scalar_test.go
- settings.go
- settings_test.go
- source.go
- source_test.go
- spec.go
- types.go
- types_test.go
- binder.go
- catalog.go
- catalog_test.go
- config.go
- contracts.go
- coordinator.go
- coordinator_test.go
- epoch.go
- epoch_test.go
- errors.go
- errors_test.go
- events.go
- events_test.go
- host.go
- key.go
- lease.go
- lifecycle_test.go
- manager.go
- manager_test.go
- observer.go
- observer_test.go
- options.go
- prompt.go
- remove_agent_test.go
- resume_test.go
- session.go
- session_test.go
- sink.go
- sink_test.go
- start_options.go
- start_options_test.go
- stream_helpers_test.go
- turn.go
- turn_contract_test.go
- attach_test.go
- bind_test.go
- builder.go
- builder_test.go
- config.go
- config_test.go
- dynamic.go
- dynamic_test.go
- errors.go
- errors_test.go
- events.go
- generation.go
- helpers_test.go
- host.go
- host_contract_test.go
- host_test.go
- lifecycle.go
- lifecycle_test.go
- registry.go
- reload.go
- reload_test.go
- runtime.go
- runtime_integration_test.go
- runtime_resource_test.go
- target_source_test.go
- bridge.go
- bridge_linux.go
- bridge_other.go
- doc.go
- flags.go
- register.go
- register_test.go
- runner.go
- runner_linux.go
- runner_other.go
- local.go
- resource.go
- resource_test.go
- session_other.go
- session_unix.go
- doc.go
- profile.go
- register.go
- register_test.go
- runner.go
- runner_darwin.go
- runner_other.go
- allowlist.go
- allowlist_test.go
- approval.go
- compose.go
- contract.go
- decorator.go
- decorator_test.go
- doc.go
- enforcement.go
- exec.go
- exec_test.go
- path_resolve.go
- policy.go
- process_helpers.go
- session.go
- session_other.go
- session_registry.go
- session_registry_internal_test.go
- session_test.go
- session_unix.go
- session_unix_internal_test.go
- watcher_other.go
- watcher_unix.go
- logfile.go
- logfile_test.go
- attrs.go
- attrs_test.go
- init_all.go
- init_all_test.go
- log.go
- log_test.go
- logger.go
- logger_test.go
- meter.go
- meter_test.go
- otlp.go
- otlp_test.go
- resource.go
- resource_test.go
- telemetry.go
- telemetry_test.go
- trace.go
- trace_test.go
- adapter.go
- config.go
- config_test.go
- doc.go
- errors.go
- resources.go
- source.go
- source_test.go
- transport.go
- transport_test.go
- middleware_approval.go
- middleware_audit.go
- middleware_concurrency.go
- middleware_internal_test.go
- middleware_ratelimit.go
- middleware_recordcalls.go
- middleware_recover.go
- middleware_redact.go
- middleware_resultlimit.go
- middleware_telemetry.go
- middleware_test.go
- middleware_timeout.go
- recordcalls_test.go
- redact_test.go
- resource.go
- resource_test.go
- resultlimit_test.go
- settings.go
- catalog_suite.go
- doc.go
- fixtures.go
- recording.go
- source_suite.go
- tool_suite.go
- tooltest_test.go
- assembly.go
- assembly_test.go
- catalog.go
- executor.go
- executor_test.go
- exposure.go
- registry.go
- registry_test.go
- resource.go
- resource_test.go
- search.go
- session.go
- session_load_test.go
- session_test.go
- source.go
- state.go
- tool.go
- tool_search.go
- tooltest_suite_test.go
- visibility.go
- bundle.go
- ca.go
- engine.go
- doc.go
- hostmatch.go
- matcher.go
- netproxy.go
- policy.go
- decode.go
- decode_test.go
- httpkit.go
- capabilities.go
- capabilities_test.go
- context.go
- context_test.go
- helpers.go
- helpers_test.go
- local.go
- local_test.go
- resource.go
- resource_test.go
- scoped.go
- scoped_test.go
- sub.go
- sub_test.go
- testhelper_test.go
- workspace.go
- go.mod
- go.sum
- delegation.md
- deploy.md
- event.md
- graph.md
- inference.md
- memory.md
- prompt.md
- resource.md
- runtime.md
- sandbox.md
- tool.md
- workspace.md
- core-v0.1.0.md
- _config.yml
- index.md
- catalog.go
- catalog_test.go
- client.go
- conformance_test.go
- doc.go
- errors.go
- generate.go
- generate_anthropic.go
- generate_open.go
- generate_stream.go
- go.mod
- go.sum
- resource.go
- resource_test.go
- spec.go
- telemetry.go
- catalog.go
- client.go
- conformance_test.go
- doc.go
- embed.go
- errors.go
- extensions.go
- extensions_test.go
- generate.go
- generate_open.go
- generate_openai.go
- generate_stream.go
- go.mod
- go.sum
- image.go
- image_test.go
- output.go
- resource.go
- resource_test.go
- spec.go
- telemetry.go
- tts.go
- catalog.go
- catalog_test.go
- client.go
- conformance_test.go
- doc.go
- embed.go
- errors.go
- extensions.go
- extensions_test.go
- generate.go
- generate_ark.go
- generate_open.go
- generate_stream.go
- go.mod
- go.sum
- image.go
- image_test.go
- output.go
- resource.go
- resource_test.go
- spec.go
- telemetry.go
- transcribe.go
- transcribe_test.go
- tts.go
- video.go
- catalog.go
- catalog_test.go
- client.go
- conformance_test.go
- doc.go
- errors.go
- extensions.go
- generate.go
- generate_chat.go
- generate_open.go
- generate_responses.go
- generate_test.go
- go.mod
- go.sum
- resource.go
- resource_test.go
- spec.go
- telemetry.go
- catalog.go
- catalog_test.go
- client.go
- conformance_test.go
- doc.go
- errors.go
- extensions.go
- generate.go
- generate_chat.go
- generate_stream.go
- go.mod
- go.sum
- resource.go
- resource_test.go
- spec.go
- telemetry.go
- catalog.go
- catalog_test.go
- client.go
- conformance_test.go
- doc.go
- errors.go
- extensions.go
- generate.go
- generate_anthropic.go
- generate_open.go
- generate_stream.go
- go.mod
- go.sum
- image.go
- kernel.go
- ledger.go
- media.go
- messages_errors.go
- music.go
- resource.go
- resource_test.go
- spec.go
- telemetry.go
- tts.go
- video.go
- catalog.go
- catalog_test.go
- client.go
- conformance_new_test.go
- conformance_test.go
- doc.go
- embed.go
- errors.go
- extensions.go
- generate.go
- generate_chat.go
- generate_chat_test.go
- generate_open.go
- generate_openai.go
- generate_openai_operations_test.go
- generate_openai_test.go
- generate_stream.go
- generate_stream_internal_test.go
- go.mod
- go.sum
- image.go
- output.go
- resource.go
- resource_test.go
- spec.go
- telemetry.go
- tts.go
- websearch_test.go
- catalog.go
- catalog_test.go
- client.go
- conformance_test.go
- doc.go
- embed.go
- errors.go
- extensions.go
- generate.go
- generate_stream.go
- generate_test.go
- go.mod
- go.sum
- ledger.go
- resource.go
- resource_test.go
- spec.go
- telemetry.go
- app.go
- assemble.go
- assemble_test.go
- info.go
- info_test.go
- plugins.go
- plugins_test.go
- usage.go
- chatfmt.go
- chatfmt_test.go
- commands.go
- out.go
- sink.go
- test.go
- test_test.go
- testauto.go
- tui.go
- workspace.go
- scenario.go
- scenario_test.go
- simtools.go
- tui.go
- viewport_test.go
- wrap_test.go
- 10-hello.yaml
- plugin.yaml
- README.md
- persona.yaml
- deploy.yaml
- inference.yaml
- tools.yaml
- workspace.yaml
- narrator.txt
- role_bajie.txt
- role_monster.txt
- role_tangseng.txt
- role_wukong.txt
- select_speaker.txt
- continue_check.js
- load_story_state_file.js
- narrator_publish.js
- role_bajie_publish.js
- role_monster_publish.js
- role_tangseng_publish.js
- role_wukong_publish.js
- route_speaker.js
- save_story_state.js
- select_story_step.js
- shape_story_turn.js
- start.js
- update_state.js
- assistant.yaml
- deploy.yaml
- inference.yaml
- speakers.yaml
- tools.yaml
- workspace.yaml
- call_game_event.txt
- call_game_over_event.txt
- format_player_move.txt
- seat_4_xiaoman_speak.txt
- seat_5_zhoulan_speak.txt
- seat_6_chen_doctor_speak.txt
- seat_7_laozhao_speak.txt
- seat_8_suhe_speak.txt
- apply_vote.js
- host_day_announce.js
- host_night_begin.js
- host_seer_action.js
- host_vote_prompt.js
- host_vote_result.js
- host_werewolf_action.js
- host_witch_action.js
- load_game_state.js
- post_game_host_wrap.js
- post_game_seat_1_free_chat.js
- post_game_seat_2_free_chat.js
- post_game_seat_4_free_chat.js
- post_game_seat_5_free_chat.js
- post_game_seat_6_free_chat.js
- post_game_seat_7_free_chat.js
- post_game_seat_8_free_chat.js
- prepare_user_speech.js
- prepare_vote_phase.js
- resolve_night.js
- route_post_game_chat.js
- route_setup.js
- save_game_state.js
- seat_1_lin_zhi_speak.js
- seat_2_ache_speak.js
- seat_4_xiaoman_speak_publish.js
- seat_5_zhoulan_speak_publish.js
- seat_6_chen_doctor_speak_publish.js
- seat_7_laozhao_speak_publish.js
- seat_8_suhe_speak_publish.js
- setup_game.js
- user_speech_prompt.js
- user_speech_retry.js
- validate_user_speech.js
- vote_retry.js
- write_game_audit.js
- hunter_decide.txt
- seat_speak.txt
- seer_decide.txt
- vote_decide.txt
- witch_decide.txt
- wolf_decide.txt
- wolf_discuss.txt
- command_reply.js
- dawn_resolve.js
- day_speech_rule.js
- exile_resolve.js
- host_opening.js
- host_router.js
- hunter_after.js
- hunter_rule.js
- init_game.js
- input_validate.js
- load_game_state_file.js
- night_seer_rule.js
- night_witch_rule.js
- night_wolf_rule.js
- pk_rule.js
- post_game_rule.js
- progress_route.js
- save_state.js
- seer_after.js
- speech_publish.js
- vote_after.js
- vote_rule.js
- vote_tally.js
- witch_after.js
- wolf_after_discuss.js
- wolf_decide_apply.js
- assistant.yaml
- deploy.yaml
- inference.yaml
- speakers.yaml
- tools.yaml
- workspace.yaml
- opening_self_start.yaml
- reject_scope_drift.yaml
- resolve_without_killing.yaml
- speaker_control_and_user_interrupt.yaml
- day_discuss_to_vote.yaml
- good_win_full.yaml
- invalid_night_then_recover.yaml
- night_inspect.yaml
- opening_setup.yaml
- post_game_chat.yaml
- post_game_no_restart.yaml
- post_game_role_chain.yaml
- seat_order_day_one.yaml
- vote_out_wolf.yaml
- wrong_vote_then_recover.yaml
- .gitignore
- env.go
- go.mod
- go.sum
- main.go
- README.md
- README_zh.md
- openai.yaml
- assistant.json
- .gitkeep
- deploy.yaml
- inference.yaml
- workspace.yaml
- deploy.md
- graph.md
- pitfalls.md
- resources.md
- runtime.md
- go.mod
- go.sum
- main.go
- validate-config.sh
- SKILL.md
- openai.yaml
- plugin.md
- SKILL.md
- go.mod
- main.go
- main_test.go
- .gitignore
- .golangci.yml
- CHANGELOG.legacy.md
- CHANGELOG.md
- CONTRIBUTING.md
- go.work
- LICENSE
- Makefile
- README.md
- SECURITY.md
# Installation Guide
1. Get the code
git clone https://github.com/GizClaw/flowcraft
Downloads the entire project code from GitHub to your computer.
cd flowcraft
Moves into the project folder you just downloaded.
2. Go
Medium RecommendedPrerequisites
go run . help
Runs the Go program directly without a separate build step.
go run . workspace create --config werewolf --workspace ./workspace
Runs the Go program directly without a separate build step.
go run . test -test werewolf/opening_setup
Runs the Go program directly without a separate build step.
If the build finishes without errors, it worked. If you used go run ., check the terminal output.
Pulled directly from this repo's README.
3. Make
MediumPrerequisites
- Git Needed to download the project code from GitHub.
- Make Usually pre-installed on Linux/macOS. On Windows, install separately (e.g. via MSYS2 or WSL).
make help # list every target
Compiles the code based on the generated build configuration to produce an executable.
make ci # vet + test for all in-tree modules
Compiles the code based on the generated build configuration to produce an executable.
make release-check # validate changesets and the pending release plan
Compiles the code based on the generated build configuration to produce an executable.
If it finishes without errors, it worked. Try running the generated executable directly.
Pulled directly from this repo's README.
// repository documentation
Was this content helpful?
(0 ratings)