whiteducksoftware / whiteducksoftware/flock

[1.0] Add an application-factory entry point and deterministic onboarding flow

Open
#439 0 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

enhancement
Dominant language
Python
Stars
120
Forks
14
Avg merge
19h 32m
Merged PRs (30d)
8

Description

A working server command needs a simple way to run a user's own Flock application and demonstrate the full typed-artifact path without requiring model credentials.

Scope

  • Allow the CLI to load an explicitly configured, trusted Python application factory using the existing server composition.
  • Provide one maintained deterministic example: publish typed input, run two independent producers, join their results and inspect a controlled failure.
  • Show the same application through API and dashboard, with an optional existing LLM engine path.

Acceptance criteria

  • From a fresh installation, the documented commands load the factory and produce the expected typed output without an API key.
  • The input, joined result and controlled failure can be inspected through the application API and dashboard.
  • Invalid factory references produce clear startup errors; complex input uses the JSON fallback.

Boundaries

Do not load executable application code from an untrusted HTTP request or import bundle. No new authoring DSL.

References

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Start with src/flock/cli.py and src/flock/orchestrator/server_manager.py, then inspect examples/01-getting-started/01_declarative_pizza.py and the implementation dependencies in #435 and #438. A fresh installation should load a trusted factory, run the deterministic typed-artifact flow without an API key, expose its input, joined result, and controlled failure through the API and dashboard, and report clear errors for invalid references.

Written by the indexing model from the issue text.

Assessment

Tech stack
python
Domain
api, cli, developer-experience
Issue type
Feature
Difficulty
4/5
Estimated time
3-5 days
Activity status
Active
Clarity
Mostly clear
Newbie friendliness
55/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.