')
planner_target_dropdown = gr.Dropdown(
choices=planner_target_choices(CONSTELLATIONS),
value=PLANNER_TARGET_AUTO,
label="Target",
info="Auto chooses what's up for the season at your site.",
)
target_hint_out = gr.HTML(
_render_planner_target_hint(PLANNER_TARGET_AUTO, CONSTELLATIONS_BY_NAME),
)
browse_targets_btn = gr.Button(
"Open constellation guides →",
variant="secondary",
size="sm",
)
gr.HTML('
Night setup
')
off_grid_toggle = gr.Checkbox(
label="Off Grid",
value=False,
info="Skip weather APIs. Local astronomy still runs; Modal is disabled (needs network).",
)
red_light_toggle = gr.Checkbox(
label="Red-light mode",
value=False,
info="Scotopic red palette to preserve night vision outside.",
)
with gr.Accordion("Advanced settings", open=False):
custom_loc_box = gr.Textbox(
label="Custom coordinates",
placeholder="City or address (optional)",
)
date_picker = gr.DateTime(
label="Specific date (optional)",
include_time=False,
type="datetime",
)
weather_toggle = gr.Checkbox(
label="Live weather",
value=True,
info="Open-Meteo cloud cover and moon phase for the plan.",
)
use_modal_toggle = gr.Checkbox(
label="Modal GPU polish",
value=DEFAULT_USE_MODAL_FOR_HEAVY_COMPUTE,
info="Optional cloud GPUs. Off when Off Grid or for local-only demos.",
)
submit_btn = gr.Button("Plan observation", variant="primary")
# Right Column: Visual Canvas, Telemetry & Model Tabs
with gr.Column(scale=3):
# NL suggestion area
with gr.Column(elem_classes=["planner-hint"]):
with gr.Row():
with gr.Column(scale=5):
nl_summary_out = gr.Markdown("", visible=False)
with gr.Column(scale=1, min_width=70):
clear_nl_btn = gr.Button("✕ Clear", variant="secondary", size="sm", visible=False)
nl_hint_md = gr.Markdown(
""
"Ask Orion picks a date and target from your question. Review the sidebar, then "
"Plan observation — or clear to start over."
"",
visible=True,
)
# Telemetry (Field Sketch / FLUX toggle removed — only retained Sky view is the zenith chart below)
with gr.Column(elem_classes=["card"]):
telemetry_out = gr.HTML(_render_telemetry_bar_html(None, 5, False), elem_id="telemetry-chips")
with gr.Tabs(elem_id="model-outputs", elem_classes=["model-tabs-container"]) as model_tabs:
with gr.Tab("⚡ MiniCPM"):
mini_out = gr.Markdown(
'
Your warm cottage summary appears here after you plan.
'
)
with gr.Tab("🌍 Aya (FR)"):
aya_out = gr.Markdown(
'
Le guide en français apparaît ici après la planification.
'
)
with gr.Tab("🔭 Nemotron"):
nemotron_out = gr.Markdown(
'
Expert RA/Dec, seeing, and eyepiece notes land here after you plan.
'
)
# Bottom Row: Zenith (skyview) next to History and cottage board side-by-side
with gr.Row(elem_classes=["planner-bottom-row"]):
with gr.Column(scale=2, min_width=280, elem_classes=["card", "sky-inline-card"]):
gr.Markdown("### Sky view — zenith")
gr.Markdown(
"What's directly overhead at your site right now — a quick orientation before you step outside."
)
zenith_img_planner = gr.Image(label="Zenith (live)", interactive=False)
zenith_planner_btn = gr.Button("↻ Refresh Zenith", variant="secondary", size="sm")
with gr.Column(scale=1, min_width=220, elem_classes=["card"]):
with gr.Row():
gr.HTML('
Field notes
')
reset_history_btn = gr.Button("Reset", variant="secondary", size="sm", scale=0, min_width=60)
history_out = gr.HTML(_render_history_html([]), elem_id="history-card")
with gr.Column(scale=1, min_width=220, elem_classes=["card"]):
cottage_board_out = gr.HTML(_render_cottage_board([]), elem_id="cottage-board")
with gr.Tab("Targets", id="targets-tab"):
with gr.Column(elem_classes=["card"]):
gr.Markdown(
"### Constellation guides\n"
"Finder steps, mythology, and deep-sky highlights for Nova Scotia skies. "
"Pick one below or use **Quick plan** to jump back to the Planner."
)
search_box = gr.Textbox(
placeholder="Search… Orion, Summer, Nebula, Cassiopeia",
show_label=False,
container=False,
)
constellation_html = gr.HTML(
_render_constellation_cards(CONSTELLATIONS),
elem_id="constellation-browser",
)
# Per-constellation Plan Tonight buttons (one per card, Gradio-native)
gr.HTML('
Quick plan
')
with gr.Row(elem_classes=["controls-bar"]):
plan_target_dropdown = gr.Dropdown(
choices=[c["name"] for c in CONSTELLATIONS],
value=CONSTELLATIONS[0]["name"],
label="Constellation",
show_label=False,
container=False,
scale=4,
info="Plans this target on the Planner tab with your current location and options.",
)
plan_tonight_btn = gr.Button("Plan this target →", variant="primary", scale=2)
# Backend tab removed from UI (scope cut for submission — Planner + Targets only per roadmap)
# Event Wiring
_planner_inputs = [
location_dropdown, custom_loc_box, timeframe_dropdown, date_picker,
off_grid_toggle, weather_toggle,
use_modal_toggle, red_light_toggle, history_state, target_override_state
]
_plan_outputs = [
mini_out,
aya_out,
nemotron_out,
history_state,
telemetry_out, history_out, cottage_board_out,
]
def _planner_target_override(name: str) -> str:
return "Auto" if name == PLANNER_TARGET_AUTO else name
def _on_planner_target_pick(name: str):
sync_targets = (
gr.update(value=name)
if name != PLANNER_TARGET_AUTO
else gr.update()
)
return (
_planner_target_override(name),
_render_planner_target_hint(name, CONSTELLATIONS_BY_NAME),
sync_targets,
)
def _sync_planner_from_targets_tab(name: str):
return (
gr.update(value=name),
_render_planner_target_hint(name, CONSTELLATIONS_BY_NAME),
name,
)
def _browse_targets_tab(planner_target: str):
targets_dd = (
gr.update(value=planner_target)
if planner_target != PLANNER_TARGET_AUTO
else gr.update()
)
return gr.update(selected="targets-tab"), targets_dd
def _plan_loading_updates(use_modal: bool, *, busy_label: str = "Planning…"):
if os.getenv("ORION_MINI_ONLY", "0").lower() in ("1", "true", "yes"):
btn_label = "Planning with MiniCPM (troubleshoot mode)…"
# Still render three panels in the UI (they will all receive the mini result)
use_modal_for_label = False
else:
btn_label = "Warming 3 GPU workers…" if use_modal else busy_label
use_modal_for_label = use_modal
return (
gr.update(interactive=False, value=btn_label),
gr.update(value=_render_planning_panel("MiniCPM", use_modal=use_modal_for_label)),
gr.update(value=_render_planning_panel("Aya (FR)", use_modal=use_modal_for_label)),
gr.update(value=_render_planning_panel("Nemotron", use_modal=use_modal_for_label)),
)
def _reenable_submit_btn(obs_date):
lbl = "Plan observation"
if not obs_date:
lbl = "Plan tonight"
else:
try:
if isinstance(obs_date, str):
date_str = obs_date[:10] if "T" in obs_date or " " in obs_date else obs_date
d = datetime.strptime(date_str, "%Y-%m-%d").date()
else:
d = obs_date.date() if hasattr(obs_date, "date") else obs_date
lbl = f"Plan for {d.strftime('%b %d')}"
except Exception:
lbl = "Plan observation"
return gr.update(interactive=True, value=lbl)
planner_target_dropdown.change(
fn=_on_planner_target_pick,
inputs=[planner_target_dropdown],
outputs=[target_override_state, target_hint_out, plan_target_dropdown],
)
plan_target_dropdown.change(
fn=_sync_planner_from_targets_tab,
inputs=[plan_target_dropdown],
outputs=[planner_target_dropdown, target_hint_out, target_override_state],
)
browse_targets_btn.click(
fn=_browse_targets_tab,
inputs=[planner_target_dropdown],
outputs=[main_tabs, plan_target_dropdown],
)
submit_btn.click(
fn=_plan_loading_updates,
inputs=[use_modal_toggle],
outputs=[submit_btn, mini_out, aya_out, nemotron_out],
).then(
fn=_on_plan_click,
inputs=_planner_inputs,
outputs=_plan_outputs
).then(
fn=_generate_zenith_chart,
inputs=[
location_dropdown, custom_loc_box, off_grid_toggle, red_light_toggle,
target_override_state,
],
outputs=[zenith_img_planner]
).then(
fn=lambda: (gr.update(visible=False, value=""), gr.update(visible=False), gr.update(visible=True)),
inputs=None,
outputs=[nl_summary_out, clear_nl_btn, nl_hint_md]
).then(
fn=_reenable_submit_btn,
inputs=[date_picker],
outputs=submit_btn
)
def _handle_nl_query(query: str, location: str, custom_loc: str, off_grid: bool, weather: bool):
if not (query or "").strip():
# Must match the 10 outputs in _nl_outputs exactly.
return (
gr.update(visible=False), gr.update(visible=False), gr.update(), gr.update(),
gr.update(), gr.update(), gr.update(), gr.update(), gr.update(), gr.update(visible=True),
)
parsed = parse_nl_query(query, preset_locations=LOCATIONS)
query_location = parsed.get("location")
effective_custom = query_location or custom_loc
loc = resolve_plan_location(location, effective_custom, off_grid, LOCATIONS)
tz_name = loc.get("tz_name")
weather_on = weather and not off_grid
best_date, summary = find_best_date(
parsed,
loc["lat"],
loc["lon"],
tz_name=tz_name,
weather_enabled=weather_on,
location_label=loc.get("display_name"),
)
plan_label = _sync_plan_button_label(best_date) if best_date else gr.update(value="Plan tonight")
nl_target = parsed.get("target") or "Auto"
if nl_target != "Auto":
target_state = nl_target
planner_dd = gr.update(value=nl_target)
hint_html = gr.update(value=_render_planner_target_hint(nl_target, CONSTELLATIONS_BY_NAME))
else:
target_state = gr.update()
planner_dd = gr.update()
hint_html = gr.update()
telemetry_html = _preview_telemetry_for_suggestion(
best_date=best_date,
target_name=nl_target if nl_target != "Auto" else "Auto",
lat=loc["lat"],
lon=loc["lon"],
tz_name=tz_name,
off_grid=off_grid,
weather_enabled=weather_on,
location_note=loc.get("location_note"),
)
custom_loc_update = (
gr.update(value=effective_custom) if query_location else gr.update()
)
return (
gr.update(value=summary, visible=True),
gr.update(visible=True),
gr.update(value=datetime.combine(best_date, datetime.min.time())) if best_date else gr.update(),
target_state,
plan_label,
planner_dd,
hint_html,
telemetry_html,
custom_loc_update,
gr.update(visible=False),
)
_nl_outputs = [
nl_summary_out, clear_nl_btn, date_picker, target_override_state, submit_btn,
planner_target_dropdown, target_hint_out, telemetry_out, custom_loc_box, nl_hint_md,
]
nl_btn.click(
fn=_handle_nl_query,
inputs=[nl_query, location_dropdown, custom_loc_box, off_grid_toggle, weather_toggle],
outputs=_nl_outputs,
)
nl_query.submit(
fn=_handle_nl_query,
inputs=[nl_query, location_dropdown, custom_loc_box, off_grid_toggle, weather_toggle],
outputs=_nl_outputs,
)
clear_nl_btn.click(
fn=_clear_nl_suggestion,
inputs=[off_grid_toggle],
outputs=[
nl_summary_out, clear_nl_btn, date_picker, target_override_state,
planner_target_dropdown, target_hint_out, nl_hint_md, telemetry_out,
],
)
def _on_constellation_search(query: str):
filtered = _filter_constellations(CONSTELLATIONS, query)
names = [c["name"] for c in filtered]
if not names:
names = [c["name"] for c in CONSTELLATIONS]
return (
_render_constellation_cards(CONSTELLATIONS, query),
gr.Dropdown(choices=names, value=names[0]),
)
search_box.change(
fn=_on_constellation_search,
inputs=[search_box],
outputs=[constellation_html, plan_target_dropdown],
)
def _plan_from_targets(target_name, location, custom_loc, timeframe, obs_date, off_grid, weather, modal, red_light, history, _target_override):
results = _on_plan_click(
location, custom_loc, timeframe, obs_date, off_grid, weather, modal, red_light, history,
target_override=target_name
)
return (*results, gr.update(selected="planner-tab"))
plan_tonight_btn.click(
fn=lambda m: _plan_loading_updates(m, busy_label="Planning target…"),
inputs=[use_modal_toggle],
outputs=[plan_tonight_btn, mini_out, aya_out, nemotron_out],
).then(
fn=_plan_from_targets,
inputs=[plan_target_dropdown, *_planner_inputs],
outputs=[*_plan_outputs, main_tabs],
).then(
fn=_generate_zenith_chart,
inputs=[
location_dropdown, custom_loc_box, off_grid_toggle, red_light_toggle,
target_override_state,
],
outputs=[zenith_img_planner]
).then(
# Hide any active "Ask Orion" suggestion once the user plans from the Targets tab
fn=lambda: (gr.update(visible=False, value=""), gr.update(visible=False), gr.update(visible=True)),
inputs=None,
outputs=[nl_summary_out, clear_nl_btn, nl_hint_md]
).then(
fn=lambda: gr.update(interactive=True, value="Plan this target →"),
inputs=None,
outputs=plan_tonight_btn
)
zenith_planner_btn.click(
fn=_generate_zenith_chart,
inputs=[
location_dropdown, custom_loc_box, off_grid_toggle, red_light_toggle,
target_override_state,
],
outputs=[zenith_img_planner]
)
# Dynamic main action label: "Plan Tonight" vs "Plan for Jul 15" when custom date is chosen (via Ask Orion or manual)
date_picker.change(
fn=_sync_plan_button_label,
inputs=[date_picker],
outputs=[submit_btn]
)
# Reset Field Notes (history + cottage board)
reset_history_btn.click(
fn=_reset_history,
inputs=None,
outputs=[history_state, history_out, cottage_board_out]
)
off_grid_toggle.change(fn=_sync_weather_checkbox, inputs=[off_grid_toggle], outputs=[weather_toggle])
off_grid_toggle.change(fn=_sync_modal_checkbox, inputs=[off_grid_toggle], outputs=[use_modal_toggle])
red_light_toggle.change(
fn=None,
inputs=[red_light_toggle],
outputs=None,
js="(is_red) => { if(is_red) document.body.classList.add('red-light-mode'); else document.body.classList.remove('red-light-mode'); }"
)
# A4: hydrate in-memory history so cards aren't empty on first load.
def _hydrate_history(hist):
h = hist or []
return _render_history_html(h), _render_cottage_board(h)
demo.load(
fn=_hydrate_history,
inputs=[history_state],
outputs=[history_out, cottage_board_out],
).then(
# Pre-render tonight's zenith chart so the Sky view isn't empty on first visit.
fn=_generate_zenith_chart,
inputs=[
location_dropdown, custom_loc_box, off_grid_toggle, red_light_toggle,
target_override_state,
],
outputs=[zenith_img_planner],
)
# Floating Action Button (FAB)
gr.HTML("""
""")
return demo
if __name__ == "__main__":
import argparse
import logging
logging.basicConfig(
level=logging.INFO,
format="%(asctime)s %(levelname)s %(name)s: %(message)s",
)
parser = argparse.ArgumentParser(description="Orion's Cottage — Constellation Planner")
parser.add_argument(
"--port",
type=int,
default=None,
help="Port for the Gradio server (default: 7860 or GRADIO_SERVER_PORT env var)",
)
args = parser.parse_args()
# Prefer explicit --port, then GRADIO_SERVER_PORT, then 7860
preferred_port = args.port or int(os.environ.get("GRADIO_SERVER_PORT", 7860))
# Try a small range so a stale dev server on 7860 doesn't completely block you
static_dir = Path(__file__).resolve().parent / "static"
allowed = [str(static_dir)] if static_dir.is_dir() else None
app = build_app()
for port in range(preferred_port, preferred_port + 10):
try:
print(f"Starting Orion's Cottage on http://0.0.0.0:{port} (Press Ctrl+C to stop)")
app.launch(
server_name="0.0.0.0",
server_port=port,
show_error=True,
theme=midnight_oasis_theme,
css=CUSTOM_CSS,
allowed_paths=allowed,
)
break
except OSError as e:
msg = str(e).lower()
if "cannot find empty port" in msg or "address already in use" in msg:
print(f"Port {port} in use, trying {port + 1}...")
continue
raise
else:
raise SystemExit(f"Could not find a free port in {preferred_port}-{preferred_port + 9}")