Repository navigation
Releases
FZAstro AI v2.4.2
FZAstro AI v2.4.2 — OpenClaude Launch Fix
This maintenance release stabilizes the OpenClaude workspace experience and updates the user-facing setup documentation.
Highlights
-
Fixed OpenClaude launch crash from the compact terminal View menu.
-
Added missing terminal navigation callbacks for Page Up, Page Down, Top, and Bottom.
-
Kept the compact OpenClaude terminal menu layout introduced in the previous runtime UI update.
-
Clarified setup requirements in the README with a simple 1 / 2 / 3 prerequisite flow:
- Install Ollama.
- Install Node.js / npm.
- Install OpenClaude CLI.
-
Clarified that FZAstro does not bundle Ollama, Node.js/npm, or the global OpenClaude CLI.
-
Confirmed that build/deploy handles FZAstro Python dependencies, embedded terminal backend assets, PyInstaller resources, and terminal frontend assets.
OpenClaude / CLAUDE Workspace
The main chat quick action now uses CLAUDE as the primary coding assistant entry point. OpenClaude remains an external runtime dependency and is detected at runtime. Missing prerequisites should be reported clearly instead of crashing the app.
The OpenClaude terminal UI now uses compact grouped menus to avoid button clipping:
- Session
- Claude
- Input
- View
CTX / output-token cap remains configurable and applies after restarting the Claude session.
External Prerequisites
For full local AI and OpenClaude functionality, install:
winget install -e --id Ollama.Ollama
winget install -e --id OpenJS.NodeJS.LTS
npm install -g @gitlawb/openclaude@latestFZAstro itself should still launch without these tools installed, but Ollama and OpenClaude features require them.
Validation
Targeted validation covered:
- OpenClaude UI source contract
- README/version documentation checks
- release workflow script checks
- OpenClaude embedded terminal behavior
Tag
v2.4.2-openclaude-launch-fix
FZAstro AI v2.3.1
FZAstro AI v2.3.1
This release focuses on the LLM pipeline refactor, polished tool output, Web Companion parity, weather/markets/news improvements, and release hardening.
Highlights
- Refactored the LLM request pipeline into shared modules for profiles, prompt building, context budgeting, request construction, and stream parsing.
- Cleaned up calibration/profile prompts and removed legacy prompt expansion.
- Added polished assistant rendering for links, tables, code blocks, weather summaries, market summaries, and structured app/tool replies.
- Added direct weather lookup using Open-Meteo, including current conditions and daily outlook.
- Added Global Market Pulse with indices, commodities, crypto, CRM, DBX, oil, gold, and broader global indicators.
- Improved Daily News output with cleaner cards, article summaries, source metadata, and better layout.
- Upgraded Web Companion so it uses the live frontend and shared app logic instead of the older embedded/basic implementation.
- Ported Web Companion SEEING and TARGETS to the same modern planners used by the desktop app.
- Fixed Web Companion SEEING internal-server-error handling.
- Added TARGETS result caching so repeated identical target searches return instantly after the first catalogue run.
- Improved UI polish across tabs, close buttons, Codex-style dark theme, tool menus, message spacing, and output rendering.
- Improved N.I.N.A. session flow and TARGETS handoff behavior.
- Expanded automated coverage for weather, markets, Web Companion tools, LLM request building, stream parsing, prompt profiles, context budgeting, and target caching.
Validation
- Full test suite passed:
356 passed - Release build validation passed.
- EXE smoke test passed.
- Release artifact built successfully.
Artifact
FZAstroAI.exe- SHA256:
8A99B3E114B76C0204862E1F5D2FAA988EE9D625F419B580E406EBD887F85C5A
Notes
Tesseract OCR remains optional. If Tesseract is not installed or configured, OCR features are unavailable, but the main application and release validation still pass.
<style type="text/css"> p, li { white-space: pre-wrap; } hr { height: 1px; border-width: 0; } li.unchecked::marker { content: "\2610"; } li.checked::marker { content: "\2612"; } </style>FZAstro AI v2.3.1 Help
This guide shows what FZAstro AI can do and which source/mode is usually used. Imaging Production v2.3 is the tabbed workspace release: chat stays clean, astronomy tools open as main-window tabs, the root folder has one deploy button, and release deploy can create the Git commit/tag automatically. Click the FZ square in the header to open the GitHub repository.
1. Main idea
| Source chip | Meaning |
|---|---|
| LLM | The selected model answered from prompt/model reasoning. |
| Docs | The answer used the local Document Knowledge Library. |
| App | The app handled the request directly. |
| Web | The answer used internet search or webpage extraction. |
| News | The answer came from the Daily News workflow. |
| Market | The answer came from a structured market quote. |
| Memory | The answer used saved persistent memory. |
| Files | The answer used attached files. |
| Vision | An image-capable model inspected an image. |
| Python | Local Python code executed and returned output. |
Good rule:
Ask normally for model knowledge.
Mention documents / PDF title / page number for local library work.
Mention web / latest / current / URL for internet work.
Mention remember / memory for persistent memory.
Mention run / test / execute for Python.
Use DEV for project scanning, coding context, plans, and checks.
2. Normal chat
Explain dithering in astrophotography.
Help me debug this Python error.
Compare OSC and mono cameras for deep-sky imaging.
Create a simple imaging checklist for tonight.
Expected source chip: LLM.
3. Models and telemetry
Use the model selector near the chat controls to choose the active local model. Use refresh after adding/removing Ollama models. If Ollama is installed but stopped on the default local endpoint, FZAstro AI can try to start ollama serve automatically.
The status line can show model name, response time, output size, context left, and token speed. The lower telemetry row can show GPU/VRAM, CPU, RAM, and best-effort temperatures.
4. Web, news, and market
Search the web for latest Artemis news.
Read this page: https://www.nasa.gov/blogs/artemis/
Summarize this article: https://www.nasa.gov/blogs/artemis/
FZAstro AI v2.3.0 - Imaging Production
FZAstro AI v2.3.0 - Imaging Production
This release focuses on the new tabbed workspace, cleaner release/deploy flow, and polished Astro tool presentation.
Highlights
- Added main-window tabbed workspace for Chat, LOOKUP, SEEING, TARGETS, SUN NOW, N.I.N.A., Help/About, and system panels.
- Added the workspace Apps launcher so tools can be opened from any tab.
- Hid chat composer/model-thinking chrome outside the Chat tab to save space.
- Improved TARGETS layout with a larger sky preview and compact metadata under the image.
- Added LOOKUP as a tabbed tool.
- Improved SEEING planner behavior, including hourly forecast rows and clearer cloud/astro-dark reporting.
- Updated Help, About, README, and release validation text for v2.3.0.
- Added README screenshot gallery for Chat, SEEING, LOOKUP, TARGETS, SUN NOW, and N.I.N.A.
- Added root
DEPLOY.batas the one easy release button. - Added optional deploy Git automation:
DEPLOY.batbuilds, validates, commits, and creates the local tag.DEPLOY.bat -GitPushalso pushes the branch and tag.
- Cleaned stale root/runtime files and old v2.1 repair scripts from source release packaging.
Validation
- Full test suite passed:
271 passed - PowerShell deploy/validation scripts parse successfully.
- Help/About offscreen UI smoke check passed.
- Clean source ZIP verified with screenshots included and runtime/vendor folders excluded.
Release Tag
v2.3.0
Notes
The tracked OpenNGC import data remains included at:
fzastro_ai/data/NGC.csv
A loose root NGC.csv may be kept locally for manual imports, but it is not required in the clean source ZIP.
FZAstro AI v2.3.0 Help
This guide shows what FZAstro AI can do and which source/mode is usually used. Imaging Production v2.3 is the tabbed workspace release: chat stays clean, astronomy tools open as main-window tabs, the root folder has one deploy button, and release deploy can create the Git commit/tag automatically. Click the FZ square in the header to open the GitHub repository.
1. Main idea
| Source chip | Meaning |
|---|---|
| LLM | The selected model answered from prompt/model reasoning. |
| Docs | The answer used the local Document Knowledge Library. |
| App | The app handled the request directly. |
| Web | The answer used internet search or webpage extraction. |
| News | The answer came from the Daily News workflow. |
| Market | The answer came from a structured market quote. |
| Memory | The answer used saved persistent memory. |
| Files | The answer used attached files. |
| Vision | An image-capable model inspected an image. |
| Python | Local Python code executed and returned output. |
Good rule:
Ask normally for model knowledge.
Mention documents / PDF title / page number for local library work.
Mention web / latest / current / URL for internet work.
Mention remember / memory for persistent memory.
Mention run / test / execute for Python.
Use DEV for project scanning, coding context, plans, and checks.
2. Normal chat
Explain dithering in astrophotography.
Help me debug this Python error.
Compare OSC and mono cameras for deep-sky imaging.
Create a simple imaging checklist for tonight.
Expected source chip: LLM.
3. Models and telemetry
Use the model selector near the chat controls to choose the active local model. Use refresh after adding/removing Ollama models. If Ollama is installed but stopped on the default local endpoint, FZAstro AI can try to start ollama serve automatically.
The status line can show model name, response time, output size, context left, and token speed. The lower telemetry row can show GPU/VRAM, CPU, RAM, and best-effort temperatures.
4. Web, news, and market
Search the web for latest Artemis news.
Read this page: https://www.nasa.gov/blogs/artemis/
Summarize this article: https://www.nasa.gov/blogs/artemis/
Take screenshot https://www.nasa.gov/blogs/artemis/
Give me the daily news brief.
Get CRM stock price.
Get crude oil price.
Get gold price.
Expected source chips: Web, News, or Market...
FZAstro AI v2.1.0
FZAstro AI v2.1.0 focuses on the production-ready imaging workflow and N.I.N.A. integration.
Highlights
-
Added polished FZASTRO IMAGING CONTROL cockpit.
-
Simplified the imaging workflow into clear numbered actions:
- 1 · OPEN TARGETS
- 2 · CONFIRM + LOAD
- 3 · START SESSION
- STOP / ABORT
- SESSION REPORT
-
Confirmed N.I.N.A. API workflow using:
GET /sequence/load?sequenceName=...GET /sequence/startGET /sequence/stop/sequence/state/sequence/list-available
-
Generated N.I.N.A. plans now use a proper Advanced Sequencer root structure with Start, Targets, and End sections.
-
Added live session status with:
- API status
- loaded sequence
- target
- session state
- frames captured/planned
- exposure/gain
- latest captured image
-
Added FITS preview support with grayscale stretch.
-
Improved latest-image detection for N.I.N.A. folder structures using session-night folders.
-
Added safer frame counting fallback from captured image files.
-
Improved session report highlights.
-
Cleaned deploy/test anchors and release workflow stability.
Validation
Automated tests pass before release.
Notes
This release keeps FZAstro in control of planning, loading, status, and reporting while N.I.N.A. remains responsible for actual equipment execution and imaging.
FZAstro AI v2.0.0 — Version 2 Production
FZAstro AI v2.0.0 is a major cleanup and consolidation release focused on making the project structure cleaner, the documentation easier to maintain, and the Developer Workbench more directly integrated into the main application.
This release builds on the RC3 production foundation and prepares FZAstro AI for the next development phase: stronger local AI coding workflows, cleaner release maintenance, and a more organized source tree.
Highlights
- Promoted the project identity to FZAstro AI v2.0.0 / Version 2 Production
- Consolidated root documentation
- Kept only the main root
README.mdandRELEASE_VALIDATION.md - Moved detailed documentation into the
docs/folder - Removed stale patch, bundle, backup, and temporary documentation files from the project root
- Removed the separate
overlay/folder - Integrated useful overlay Developer Workbench components directly into
fzastro_ai/ - Added the Developer Workbench as a native app feature
- Added a DEV quick-action entry point
- Updated Help/About text for v2.0
- Cleaned generated cache, backup, and repair artifacts
- Improved
.gitignore - Updated PyInstaller/spec packaging around Web Companion static assets
- Updated release validation coverage for the v2.0 structure
Developer Workbench Integration
The former overlay workbench code has now been brought into the main application structure:
fzastro_ai/dev_agent/fzastro_ai/actions/dev_actions.pyfzastro_ai/ui/dev_workbench_dialog.py
This makes the coding assistant workflow part of the real application instead of a separate overlay bundle.
Astro Tools Suite
The integrated Astro Tools Suite remains a core production feature of FZAstro AI:
- SITE
- IMAGING
- LOOKUP
- SUN NOW
- SEEING / Astro Night Planner
- TARGETS
- SOLAR MAP
Validation
The v2.0 cleanup package was validated with targeted tests covering version identity, documentation layout, release workflow scripts, startup imports, Web Companion foundation, and the v2 cleanup structure.
Selected validation passed:
python -m compileall -q fzastro_ai tests
python -m pytest -q tests/test_version_and_docs.py tests/test_v2_cleanup_structure.py tests/test_web_companion_foundation.py tests/test_release_workflow_scripts.py tests/test_startup_imports.pyFZASTRO AI v1.0.0-rc4
FZAstro AI v1.0.0 RC4 — Web Companion LAN Release
This release finalizes the FZAstro AI Web Companion as a working LAN/mobile browser interface for the desktop app.
Astro Tools Suite
The integrated Astro Tools Suite remains a core production feature of FZAstro AI:
- SITE
- IMAGING
- LOOKUP
- SUN NOW
- SEEING / Astro Night Planner
- TARGETS
- SOLAR MAP
Notes
This RC4 build is intended as the clean Web Companion LAN release candidate after RC3. It includes the fixes needed for packaged EXE operation, LAN startup, health checks, and browser page loading.