aipa-cli 0.1.5__tar.gz → 0.1.7__tar.gz

{aipa_cli-0.1.5 → aipa_cli-0.1.7}/CHANGELOG.md

@@ -5,6 +5,25 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.1.7] - 2026-05-09
+
+### Fixed
+- Bridge settings.json API key to SDK Pydantic settings by seeding env vars (`OPENAI_API_KEY`, `OPENAI_BASE_URL`, `OPENAI_MODEL`) at CLI entry point before any SDK import
+
+## [0.1.6] - 2026-05-09
+
+### Added
+- Add `aipa setup` interactive CLI command for first-run configuration (language, reference ticker, API key, base URL, model)
+- Add `setup_done` flag to user settings, auto-run setup before commands that need an API key (`analyze`, `deep-research`, TUI)
+- Add "First-Run Setup" section to README documenting which commands require setup
+
+### Changed
+- Lazy-load `AgentSession` in TUI instead of creating on mount, preventing crash when no API key is configured
+- Guard agent usage in chat (`_run_agent_chat`, `_run_analyze`, `/clear`) and settings tab with `_ensure_agent()`
+
+### Fixed
+- Fix crash on `aipa` launch when no API key is configured (`OpenAIError: Missing credentials`)
+
 ## [0.1.5] - 2026-05-09
 
 ### Changed

{aipa_cli-0.1.5 → aipa_cli-0.1.7}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: aipa-cli
-Version: 0.1.5
+Version: 0.1.7
 Summary: Terminal TUI for AI-powered ticker analysis
 Project-URL: Homepage, https://github.com/quanhua92/aipriceaction
 Project-URL: Repository, https://github.com/quanhua92/aipriceaction
@@ -46,15 +46,18 @@ aipa-cli
 ## Requirements
 
 - Python 3.13+
-- An OpenAI-compatible API key (`OPENAI_API_KEY`)
+- An OpenAI-compatible API key (`OPENAI_API_KEY`) — only needed for AI analysis, not for data fetching
 - Optional: set `OPENAI_BASE_URL` for custom providers like OpenRouter
 
 ## Quick Start
 
 ```bash
-# Launch the TUI (chat, workflows, ticker browser)
+# Launch the TUI — first run auto-starts interactive setup
 aipa
 
+# Or run setup manually at any time
+aipa setup
+
 # AI analysis with default question template
 aipa analyze VCB
 
@@ -166,7 +169,7 @@ aipa deep-research --lang vn
 
 ### `aipa get-ohlcv-data`
 
-Fetch raw OHLCV data as a table (no LLM involved).
+Fetch raw OHLCV data as a table (no LLM involved, works without setup).
 
 ```
 # Default: daily data with EMA indicators
@@ -191,6 +194,29 @@ aipa get-ohlcv-data BTCUSDT --interval 1D --limit 30
 | `--ma` / `--no-ma` | Include/exclude moving averages (default: included) |
 | `--ema` | Use EMA instead of SMA |
 
+### `aipa setup`
+
+Interactive first-run configuration. Prompts for language, reference ticker, API key, base URL, and model. Settings are saved to `~/.aipriceaction/settings.json`. Re-running shows current values as defaults.
+
+```
+# Run interactively
+aipa setup
+```
+
+## First-Run Setup
+
+Commands that require an API key will auto-run `aipa setup` on first use if not yet configured. Commands that don't need an API key always work immediately.
+
+| Command | Setup required? |
+|---|---|
+| `aipa get-ohlcv-data` | No setup needed |
+| `aipa analyze VCB --context-only` | No setup needed |
+| `aipa analyze VCB --questions` | No setup needed |
+| `aipa setup` | Runs setup |
+| `aipa` | Auto-runs setup first |
+| `aipa analyze VCB` | Auto-runs setup first |
+| `aipa deep-research` | Auto-runs setup first |
+
 ## TUI
 
 Launch the TUI with `aipa`. The interface has three tabs:

{aipa_cli-0.1.5 → aipa_cli-0.1.7}/README.md

@@ -21,15 +21,18 @@ aipa-cli
 ## Requirements
 
 - Python 3.13+
-- An OpenAI-compatible API key (`OPENAI_API_KEY`)
+- An OpenAI-compatible API key (`OPENAI_API_KEY`) — only needed for AI analysis, not for data fetching
 - Optional: set `OPENAI_BASE_URL` for custom providers like OpenRouter
 
 ## Quick Start
 
 ```bash
-# Launch the TUI (chat, workflows, ticker browser)
+# Launch the TUI — first run auto-starts interactive setup
 aipa
 
+# Or run setup manually at any time
+aipa setup
+
 # AI analysis with default question template
 aipa analyze VCB
 
@@ -141,7 +144,7 @@ aipa deep-research --lang vn
 
 ### `aipa get-ohlcv-data`
 
-Fetch raw OHLCV data as a table (no LLM involved).
+Fetch raw OHLCV data as a table (no LLM involved, works without setup).
 
 ```
 # Default: daily data with EMA indicators
@@ -166,6 +169,29 @@ aipa get-ohlcv-data BTCUSDT --interval 1D --limit 30
 | `--ma` / `--no-ma` | Include/exclude moving averages (default: included) |
 | `--ema` | Use EMA instead of SMA |
 
+### `aipa setup`
+
+Interactive first-run configuration. Prompts for language, reference ticker, API key, base URL, and model. Settings are saved to `~/.aipriceaction/settings.json`. Re-running shows current values as defaults.
+
+```
+# Run interactively
+aipa setup
+```
+
+## First-Run Setup
+
+Commands that require an API key will auto-run `aipa setup` on first use if not yet configured. Commands that don't need an API key always work immediately.
+
+| Command | Setup required? |
+|---|---|
+| `aipa get-ohlcv-data` | No setup needed |
+| `aipa analyze VCB --context-only` | No setup needed |
+| `aipa analyze VCB --questions` | No setup needed |
+| `aipa setup` | Runs setup |
+| `aipa` | Auto-runs setup first |
+| `aipa analyze VCB` | Auto-runs setup first |
+| `aipa deep-research` | Auto-runs setup first |
+
 ## TUI
 
 Launch the TUI with `aipa`. The interface has three tabs:

{aipa_cli-0.1.5 → aipa_cli-0.1.7}/src/aipriceaction_terminal/__init__.py

@@ -1,4 +1,4 @@
 """AIPriceAction Terminal - TUI chat interface for ticker analysis."""
 
-__version__ = "0.1.5"
+__version__ = "0.1.7"
 

{aipa_cli-0.1.5 → aipa_cli-0.1.7}/src/aipriceaction_terminal/app.py

@@ -38,12 +38,12 @@ class AIPriceActionApp(AppActions, App):
         self.ticker = saved["ticker"]
         self.interval = saved["interval"]
         self.language = saved["language"]
+        self.agent = None
+        self._agent_lang: str | None = None
         from aipriceaction import AIContextBuilder
         from aipriceaction import AIPriceAction as AAPClient
         self.builder = AIContextBuilder(lang=self.language)
         self.client = AAPClient()
-        from .agents import AgentSession, AgentConfig
-        self.agent = AgentSession(AgentConfig(lang=self.language))
         self._load_ticker_options()
         # Populate SettingsTab widgets with loaded values
         self.query_one("#setting-ticker", Input).value = self.ticker
@@ -69,6 +69,19 @@ class AIPriceActionApp(AppActions, App):
         except Exception as e:
             self.notify(f"Failed to load tickers: {e}", severity="error")
 
+    def _ensure_agent(self) -> bool:
+        """Lazy-create AgentSession on first use. Returns False if API key is missing."""
+        if self.agent is not None and self._agent_lang == self.language:
+            return True
+        from aipriceaction.settings import settings
+        if not settings.openai_api_key:
+            self.agent = None
+            return False
+        from .agents import AgentSession, AgentConfig
+        self.agent = AgentSession(AgentConfig(lang=self.language))
+        self._agent_lang = self.language
+        return True
+
     def compose(self) -> ComposeResult:
         yield Header(show_clock=True)
         with TabbedContent(initial="chat"):

{aipa_cli-0.1.5 → aipa_cli-0.1.7}/src/aipriceaction_terminal/chat.py

@@ -216,7 +216,8 @@ class ChatTab(Vertical):
             )
         elif cmd == "/clear":
             log.clear()
-            self.app.agent.clear_history()
+            if self.app.agent is not None:
+                self.app.agent.clear_history()
         elif cmd == "/exit":
             self.app.exit()
         elif cmd == "/analyze":
@@ -322,6 +323,13 @@ class ChatTab(Vertical):
         """Build context and stream AI analysis for a ticker."""
         log = self.query_one("#chat-log", RichLog)
         try:
+            if not self.app._ensure_agent():
+                log.write(
+                    "[bold yellow]API key not configured.[/bold yellow]\n"
+                    "Set it in the Settings tab or run [bold]aipa setup[/bold]."
+                )
+                return
+
             builder = self.app.builder
 
             # Build context without system prompt (agent has it already)
@@ -389,6 +397,12 @@ class ChatTab(Vertical):
     async def _run_agent_chat(self, message: str) -> None:
         """Stream an agent response into the chat log."""
         log = self.query_one("#chat-log", RichLog)
+        if not self.app._ensure_agent():
+            log.write(
+                "[bold yellow]API key not configured.[/bold yellow]\n"
+                "Set it in the Settings tab or run [bold]aipa setup[/bold]."
+            )
+            return
         try:
             await stream_agent_to_log(
                 log,

{aipa_cli-0.1.5 → aipa_cli-0.1.7}/src/aipriceaction_terminal/cli.py

@@ -3,7 +3,18 @@
 import argparse
 
 
+def _ensure_setup() -> None:
+    """Run interactive setup if setup_done is not set."""
+    from .user_settings import load_settings
+    if not load_settings().get("setup_done"):
+        from .cli_setup import cmd_setup
+        cmd_setup()
+
+
 def run():
+    from .user_settings import apply_settings_to_env
+    apply_settings_to_env()
+
     parser = argparse.ArgumentParser(prog="aipa", description="AIPriceAction terminal")
     sub = parser.add_subparsers(dest="command")
 
@@ -44,15 +55,24 @@ def run():
     p_deep.add_argument("--output", default=None, help="Save final report to file")
     p_deep.add_argument("--lang", default=None, choices=["en", "vn"], help="Override language")
 
+    # aipa setup
+    sub.add_parser("setup", help="Interactive first-run setup")
+
     args = parser.parse_args()
 
-    if args.command == "analyze":
+    if args.command == "setup":
+        from .cli_setup import cmd_setup
+        cmd_setup()
+    elif args.command == "analyze":
+        if not getattr(args, "context_only", False) and not getattr(args, "questions", False):
+            _ensure_setup()
         from .cli_commands import cmd_analyze
         cmd_analyze(args)
     elif args.command == "get-ohlcv-data":
         from .cli_commands import cmd_get_ohlcv
         cmd_get_ohlcv(args)
     elif args.command == "deep-research":
+        _ensure_setup()
         from .cli_commands import cmd_deep_research
         cmd_deep_research(
             question=" ".join(args.question) if args.question else "",
@@ -61,5 +81,6 @@ def run():
             lang=args.lang,
         )
     else:
+        _ensure_setup()
         from .app import main
         main()

aipa_cli-0.1.7/src/aipriceaction_terminal/cli_setup.py

@@ -0,0 +1,71 @@
+"""Interactive first-run setup for aipa CLI (plain terminal, no TUI)."""
+
+from .user_settings import load_settings, save_settings
+
+
+_DEFAULT_BASE_URL = "https://openrouter.ai/api/v1"
+_DEFAULT_MODEL = "openai/gpt-oss-120b:free"
+
+
+def cmd_setup() -> None:
+    """Run interactive setup and save settings."""
+    current = load_settings()
+
+    print("AIPriceAction Terminal Setup")
+    print("=" * 30)
+
+    # Language
+    lang = _prompt(
+        "Language (en/vn)",
+        current.get("language", "en"),
+    )
+    if lang not in ("en", "vn"):
+        print("Invalid language, defaulting to 'en'.")
+        lang = "en"
+
+    # Reference ticker
+    ticker = _prompt(
+        "Reference ticker",
+        current.get("ticker", "VNINDEX"),
+    )
+
+    # API key (optional)
+    api_key = _prompt(
+        "API key (press Enter to skip)",
+        current.get("api_key", ""),
+    )
+
+    # Base URL
+    base_url = _prompt(
+        "Base URL",
+        current.get("openai_base_url") or _DEFAULT_BASE_URL,
+    )
+
+    # Model
+    model = _prompt(
+        "Model",
+        current.get("openai_model") or _DEFAULT_MODEL,
+    )
+
+    data = {
+        "ticker": ticker.upper(),
+        "interval": current.get("interval", "1D"),
+        "language": lang,
+        "api_key": api_key,
+        "openai_base_url": base_url,
+        "openai_model": model,
+        "setup_done": True,
+    }
+
+    save_settings(data)
+    print("Setup complete.")
+
+
+def _prompt(label: str, default: str) -> str:
+    """Prompt user with current default shown in brackets."""
+    hint = f" [{default}]" if default else ""
+    try:
+        value = input(f"{label}{hint}: ").strip()
+    except EOFError:
+        return default
+    return value if value else default

{aipa_cli-0.1.5 → aipa_cli-0.1.7}/src/aipriceaction_terminal/settings_tab.py

@@ -151,8 +151,13 @@ class SettingsTab(Vertical):
                 self.app.language = language
                 from aipriceaction import AIContextBuilder
                 self.app.builder = AIContextBuilder(lang=language)
-                from .agents import AgentSession, AgentConfig
-                self.app.agent = AgentSession(AgentConfig(lang=language))
+                try:
+                    from .agents import AgentSession, AgentConfig
+                    self.app.agent = AgentSession(AgentConfig(lang=language))
+                    self.app._agent_lang = language
+                except Exception:
+                    self.app.agent = None
+                    self.app._agent_lang = None
 
             data: dict = {
                 "ticker": ticker,

{aipa_cli-0.1.5 → aipa_cli-0.1.7}/src/aipriceaction_terminal/user_settings.py

@@ -1,6 +1,7 @@
 """Persistent user settings stored in ~/.aipriceaction/settings.json."""
 
 import json
+import os
 from pathlib import Path
 
 _CONFIG_DIR = Path.home() / ".aipriceaction"
@@ -13,6 +14,7 @@ _DEFAULTS = {
     "api_key": "",
     "openai_base_url": "",
     "openai_model": "",
+    "setup_done": False,
 }
 
 
@@ -28,3 +30,21 @@ def save_settings(data: dict) -> None:
     """Persist settings to disk, creating the config directory if needed."""
     _CONFIG_DIR.mkdir(parents=True, exist_ok=True)
     _SETTINGS_FILE.write_text(json.dumps(data, indent=2))
+
+
+def apply_settings_to_env() -> None:
+    """Seed environment variables from settings.json.
+
+    Uses ``os.environ.setdefault`` so that existing env vars always win.
+    Must be called before any SDK import that reads env vars.
+    """
+    settings = load_settings()
+    _mapping = {
+        "OPENAI_API_KEY": "api_key",
+        "OPENAI_BASE_URL": "openai_base_url",
+        "OPENAI_MODEL": "openai_model",
+    }
+    for env_key, settings_key in _mapping.items():
+        value = settings.get(settings_key, "")
+        if value:
+            os.environ.setdefault(env_key, value)