acra-cli 0.1.3__tar.gz → 0.1.5__tar.gz

{acra_cli-0.1.3/acra_cli.egg-info → acra_cli-0.1.5}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: acra-cli
-Version: 0.1.3
+Version: 0.1.5
 Summary: Agentic CLI for LLM task execution, research, and workflow automation.
 Author: Raj Tembe
 License: GNU Affero General Public License v3
@@ -79,6 +79,23 @@ It is built for developers who want a local CLI for asking an LLM-powered agent
 - ChromaDB-backed vector memory and JSON workflow memory modules
 - Optional extras for provider-specific dependencies and checkpoint backends
 
+## What's New in 0.1.5
+
+### New features
+
+- Provider credentials can now be stored with `acra keys` and used directly by Gemini, OpenAI, Groq, and HuggingFace Cloud workflows.
+- The configuration wizard stores provider and research credentials outside the plaintext profile file, using the OS keyring when available and a permission-restricted local fallback otherwise.
+- Long-running task and research commands show a live progress spinner.
+- Task and research results are rendered as readable summaries, findings, sources, and generated-file lists instead of raw workflow state.
+- Commands launched from the interactive shell now stream their output live.
+
+### Bug fixes
+
+- Fixed saved provider keys not being read by LLM initialization.
+- Fixed profile setup writing API and research keys to plaintext configuration.
+- Fixed interactive-shell commands buffering output until completion.
+- Fixed unwieldy raw dictionary and message-object output after task or research runs.
+
 ## Requirements
 
 - Python `>=3.11`
@@ -157,7 +174,7 @@ acra config show
 Store a key in your OS keyring:
 
 ```bash
-acra keys set provider
+acra keys set GEMINI_API_KEY
 ```
 
 Run a research workflow:
@@ -304,13 +321,13 @@ The setup wizard prompts for:
 Set a key interactively:
 
 ```bash
-acra keys set provider
+acra keys set OPENAI_API_KEY
 ```
 
 Set a key directly:
 
 ```bash
-acra keys set provider "your-key"
+acra keys set OPENAI_API_KEY "your-key"
 ```
 
 List key status:
@@ -322,9 +339,11 @@ acra keys list
 Delete a key:
 
 ```bash
-acra keys delete provider
+acra keys delete OPENAI_API_KEY
 ```
 
+Supported provider key names are `GEMINI_API_KEY`, `OPENAI_API_KEY`, `GROQ_API_KEY`, and `HF_API_KEY`. Keys are stored in your OS keyring when it is available. On systems without a keyring backend, acra uses a local credentials file with owner-only permissions.
+
 Research key names:
 
 ```bash
@@ -336,7 +355,10 @@ acra keys set research.arxiv
 
 Environment fallback variables:
 
-- `ACRA_PROVIDER_KEY`
+- `GEMINI_API_KEY` or `GOOGLE_GEMINI_API_KEY`
+- `OPENAI_API_KEY`
+- `GROQ_API_KEY`
+- `HF_API_KEY`
 - `ACRA_RESEARCH_WEB_KEY`
 - `ACRA_RESEARCH_GITHUB_KEY`
 - `ACRA_RESEARCH_DOCS_KEY`
@@ -439,9 +461,9 @@ acra config show
 Keys:
 
 ```bash
-acra keys set provider
+acra keys set GEMINI_API_KEY
 acra keys list
-acra keys delete provider
+acra keys delete GEMINI_API_KEY
 ```
 
 Memory:
@@ -548,6 +570,7 @@ export OMNIAGENT_DATA_DIR=/path/to/acra-data
 
 Important subdirectories:
 
+- `credentials.json`: permission-restricted credential fallback when no OS keyring is available
 - `projects/`: generated project files
 - `memory/storage/`: JSON memory files
 - `memory/chroma_db/`: ChromaDB vector memory
@@ -555,7 +578,7 @@ Important subdirectories:
 
 ## Current Beta Notes
 
-- The package version is `0.1.2`.
+- The package version is `0.1.5`.
 - The top-level CLI currently attaches `serve`, `config`, `keys`, `research`, `memory`, `session`, `graph`, and `workspace`.
 - The codebase contains additional command modules such as `brain`, `context`, `logs`, and `plugin`, but they are not currently attached to the top-level CLI.
 - Some CLI command groups return placeholder output while the Python modules behind them continue to evolve.
@@ -587,7 +610,7 @@ export HF_API_KEY="your-token"
 Or store it with:
 
 ```bash
-acra keys set provider
+acra keys set GEMINI_API_KEY
 ```
 
 ### Ollama connection failure
@@ -616,7 +639,7 @@ export OLLAMA_BASE_URL=http://localhost:11434
 - PyPI package name: `acra-cli`
 - Console command: `acra`
 - Python import package: `acra`
-- Version: `0.1.2`
+- Version: `0.1.5`
 - Python: `>=3.11`
 - Console script: `acra=acra.cli:app_main`
 - Author: Raj Tembe

{acra_cli-0.1.3 → acra_cli-0.1.5}/README.md

@@ -23,6 +23,23 @@ It is built for developers who want a local CLI for asking an LLM-powered agent
 - ChromaDB-backed vector memory and JSON workflow memory modules
 - Optional extras for provider-specific dependencies and checkpoint backends
 
+## What's New in 0.1.5
+
+### New features
+
+- Provider credentials can now be stored with `acra keys` and used directly by Gemini, OpenAI, Groq, and HuggingFace Cloud workflows.
+- The configuration wizard stores provider and research credentials outside the plaintext profile file, using the OS keyring when available and a permission-restricted local fallback otherwise.
+- Long-running task and research commands show a live progress spinner.
+- Task and research results are rendered as readable summaries, findings, sources, and generated-file lists instead of raw workflow state.
+- Commands launched from the interactive shell now stream their output live.
+
+### Bug fixes
+
+- Fixed saved provider keys not being read by LLM initialization.
+- Fixed profile setup writing API and research keys to plaintext configuration.
+- Fixed interactive-shell commands buffering output until completion.
+- Fixed unwieldy raw dictionary and message-object output after task or research runs.
+
 ## Requirements
 
 - Python `>=3.11`
@@ -101,7 +118,7 @@ acra config show
 Store a key in your OS keyring:
 
 ```bash
-acra keys set provider
+acra keys set GEMINI_API_KEY
 ```
 
 Run a research workflow:
@@ -248,13 +265,13 @@ The setup wizard prompts for:
 Set a key interactively:
 
 ```bash
-acra keys set provider
+acra keys set OPENAI_API_KEY
 ```
 
 Set a key directly:
 
 ```bash
-acra keys set provider "your-key"
+acra keys set OPENAI_API_KEY "your-key"
 ```
 
 List key status:
@@ -266,9 +283,11 @@ acra keys list
 Delete a key:
 
 ```bash
-acra keys delete provider
+acra keys delete OPENAI_API_KEY
 ```
 
+Supported provider key names are `GEMINI_API_KEY`, `OPENAI_API_KEY`, `GROQ_API_KEY`, and `HF_API_KEY`. Keys are stored in your OS keyring when it is available. On systems without a keyring backend, acra uses a local credentials file with owner-only permissions.
+
 Research key names:
 
 ```bash
@@ -280,7 +299,10 @@ acra keys set research.arxiv
 
 Environment fallback variables:
 
-- `ACRA_PROVIDER_KEY`
+- `GEMINI_API_KEY` or `GOOGLE_GEMINI_API_KEY`
+- `OPENAI_API_KEY`
+- `GROQ_API_KEY`
+- `HF_API_KEY`
 - `ACRA_RESEARCH_WEB_KEY`
 - `ACRA_RESEARCH_GITHUB_KEY`
 - `ACRA_RESEARCH_DOCS_KEY`
@@ -383,9 +405,9 @@ acra config show
 Keys:
 
 ```bash
-acra keys set provider
+acra keys set GEMINI_API_KEY
 acra keys list
-acra keys delete provider
+acra keys delete GEMINI_API_KEY
 ```
 
 Memory:
@@ -492,6 +514,7 @@ export OMNIAGENT_DATA_DIR=/path/to/acra-data
 
 Important subdirectories:
 
+- `credentials.json`: permission-restricted credential fallback when no OS keyring is available
 - `projects/`: generated project files
 - `memory/storage/`: JSON memory files
 - `memory/chroma_db/`: ChromaDB vector memory
@@ -499,7 +522,7 @@ Important subdirectories:
 
 ## Current Beta Notes
 
-- The package version is `0.1.2`.
+- The package version is `0.1.5`.
 - The top-level CLI currently attaches `serve`, `config`, `keys`, `research`, `memory`, `session`, `graph`, and `workspace`.
 - The codebase contains additional command modules such as `brain`, `context`, `logs`, and `plugin`, but they are not currently attached to the top-level CLI.
 - Some CLI command groups return placeholder output while the Python modules behind them continue to evolve.
@@ -531,7 +554,7 @@ export HF_API_KEY="your-token"
 Or store it with:
 
 ```bash
-acra keys set provider
+acra keys set GEMINI_API_KEY
 ```
 
 ### Ollama connection failure
@@ -560,7 +583,7 @@ export OLLAMA_BASE_URL=http://localhost:11434
 - PyPI package name: `acra-cli`
 - Console command: `acra`
 - Python import package: `acra`
-- Version: `0.1.2`
+- Version: `0.1.5`
 - Python: `>=3.11`
 - Console script: `acra=acra.cli:app_main`
 - Author: Raj Tembe

{acra_cli-0.1.3 → acra_cli-0.1.5}/acra/__init__.py

@@ -1,6 +1,6 @@
 """acra package root."""
 
-__version__ = "0.1.2"
+__version__ = "0.1.5"
 
 from .cli import main
 

{acra_cli-0.1.3 → acra_cli-0.1.5}/acra/agents/llm.py

@@ -73,10 +73,17 @@ class LLMInitializationError(Exception):
 
 def _init_gemini():
     """Initialize Google Gemini LLM."""
-    gemini_api_key = os.getenv("GOOGLE_GEMINI_API_KEY") or os.getenv("GEMINI_API_KEY")
+    from acra.utils.keyring_manager import get_key
+
+    gemini_api_key = (
+        os.getenv("GOOGLE_GEMINI_API_KEY")
+        or os.getenv("GEMINI_API_KEY")
+        or get_key("GEMINI_API_KEY")
+    )
     if not gemini_api_key or gemini_api_key.startswith("your_"):
         raise EnvironmentError(
-            "GEMINI_API_KEY is not set. Add GOOGLE_GEMINI_API_KEY to your .env file."
+            "GEMINI_API_KEY is not set. Run 'acra keys set GEMINI_API_KEY' "
+            "or add GOOGLE_GEMINI_API_KEY to your .env file."
         )
     os.environ["GOOGLE_API_KEY"] = gemini_api_key
     return ChatGoogleGenerativeAI(
@@ -91,10 +98,13 @@ def _init_openai():
         raise LLMInitializationError(
             "OpenAI support is not installed. Install with: pip install langchain-openai"
         )
-    openai_api_key = os.getenv("OPENAI_API_KEY")
+    from acra.utils.keyring_manager import get_key
+
+    openai_api_key = os.getenv("OPENAI_API_KEY") or get_key("OPENAI_API_KEY")
     if not openai_api_key or openai_api_key.startswith("your_"):
         raise LLMInitializationError(
-            "OPENAI_API_KEY is not set. Add OPENAI_API_KEY to your .env file."
+            "OPENAI_API_KEY is not set. Run 'acra keys set OPENAI_API_KEY' "
+            "or add OPENAI_API_KEY to your .env file."
         )
     return ChatOpenAI(
         model=OPENAI_MODEL,
@@ -109,10 +119,13 @@ def _init_groq():
         raise LLMInitializationError(
             "Groq support is not installed. Install with: pip install langchain-groq"
         )
-    groq_api_key = os.getenv("GROQ_API_KEY")
+    from acra.utils.keyring_manager import get_key
+
+    groq_api_key = os.getenv("GROQ_API_KEY") or get_key("GROQ_API_KEY")
     if not groq_api_key or groq_api_key.startswith("your_"):
         raise LLMInitializationError(
-            "GROQ_API_KEY is not set. Add GROQ_API_KEY to your .env file."
+            "GROQ_API_KEY is not set. Run 'acra keys set GROQ_API_KEY' "
+            "or add GROQ_API_KEY to your .env file."
         )
     return ChatGroq(
         model=GROQ_MODEL,
@@ -150,10 +163,13 @@ def _init_huggingface_cloud():
             "HuggingFace not installed. Install with: pip install langchain-huggingface"
         )
 
-    huggingface_api_key = os.getenv("HF_API_KEY")
+    from acra.utils.keyring_manager import get_key
+
+    huggingface_api_key = os.getenv("HF_API_KEY") or get_key("HF_API_KEY")
     if not huggingface_api_key or huggingface_api_key.startswith("your_"):
         raise LLMInitializationError(
-            "HF_API_KEY is not set. Add HF_API_KEY to your .env file. "
+            "HF_API_KEY is not set. Run 'acra keys set HF_API_KEY' or add "
+            "HF_API_KEY to your .env file. "
             "Get a token at: https://huggingface.co/settings/tokens"
         )
 

{acra_cli-0.1.3 → acra_cli-0.1.5}/acra/cli.py

@@ -72,11 +72,17 @@ def main(
     verbose: bool = typer.Option(False, "--verbose", "-v", help="Enable verbose logging."),
     quiet: bool = typer.Option(False, "--quiet", "-q", help="Suppress output."),
     timeout: int = typer.Option(0, "--timeout", help="Override execution timeout in seconds."),
+    party: bool = typer.Option(
+        False,
+        "--party",
+        "--easter-egg",
+        help="Show the rainbow party-mode startup banner.",
+    ),
 ):
     """acra: Agentic CLI for LLM powered task execution and research workflows."""
     if ctx.invoked_subcommand is None:
-        launch_shell(profile=profile, workspace=workspace)
+        launch_shell(profile=profile, workspace=workspace, party=party)
 
 
 if __name__ == "__main__":
-    app_main()
+    app_main()

{acra_cli-0.1.3 → acra_cli-0.1.5}/acra/commands/ask.py

@@ -1,11 +1,14 @@
 """Agent task commands for acra."""
 
+import uuid
 from typing import Optional
 
 import typer
 
 from acra.graph.workflow import OmniAgentCallbacks, omniagent_graph
 from acra.ui.components import render_panel
+from acra.ui.spinner import run_with_spinner
+from acra.utils.output_formatter import format_task_result
 
 app = typer.Typer(help="Agent task commands for acra.")
 
@@ -24,8 +27,23 @@ def _run_task(
         "profile": profile,
         "interactive": interactive,
     }
-    result = omniagent_graph.invoke(state, config={"callbacks": [OmniAgentCallbacks()]})
-    render_panel(result, title=task_label)
+    # The compiled graph always carries a checkpointer, which requires a
+    # thread_id on every invoke call regardless of whether the caller wants
+    # persistence. A fresh id is generated per invocation; when --no-memory
+    # is set, nothing is done with it beyond satisfying the checkpointer, so
+    # no state is meaningfully persisted or reused across runs.
+    thread_id = str(uuid.uuid4())
+    config = {
+        "callbacks": [OmniAgentCallbacks()],
+        "configurable": {"thread_id": thread_id},
+    }
+    result = run_with_spinner(
+        omniagent_graph.invoke,
+        state,
+        config=config,
+        message=f"Running {task_label}",
+    )
+    render_panel(format_task_result(result), title=task_label)
     return result
 
 
@@ -92,4 +110,4 @@ def run(
     interactive: bool = typer.Option(False, "--interactive", help="Route agent approval requests to the human node."),
 ):
     """Execute a task using the executor agent."""
-    return _run_task(task, "run", profile, use_memory, interactive)
+    return _run_task(task, "run", profile, use_memory, interactive)

{acra_cli-0.1.3 → acra_cli-0.1.5}/acra/commands/keys.py

@@ -16,7 +16,11 @@ app = typer.Typer(help="Key management commands for acra.")
 
 @app.command("set")
 def set_key_cmd(
-    name: str = typer.Argument(..., help="Key name, e.g. provider or research.github"),
+    name: str = typer.Argument(
+        ...,
+        help="Key name: GEMINI_API_KEY, OPENAI_API_KEY, GROQ_API_KEY, HF_API_KEY, "
+        "or research.<source> (web, github, docs, arxiv).",
+    ),
     value: Optional[str] = typer.Argument(None, help="API key value. If omitted, you will be prompted."),
 ):
     """Set a provider or research API key."""
@@ -37,4 +41,4 @@ def list_key_cmd():
 def delete_key_cmd(name: str = typer.Argument(..., help="Key name to delete.")):
     """Delete a configured API key."""
     delete_key(name)
-    render_panel(f"Deleted key: {name}")
+    render_panel(f"Deleted key: {name}")

{acra_cli-0.1.3 → acra_cli-0.1.5}/acra/commands/research.py

@@ -1,6 +1,7 @@
 """Research command module for acra."""
 
 import json
+import uuid
 import typer
 from typing import List, Optional
 
@@ -9,6 +10,7 @@ from acra.config.profile_manager import ProfileManager
 from acra.utils.output_formatter import format_research_report
 from acra.utils.keyring_manager import get_research_key_status
 from acra.ui.components import render_panel
+from acra.ui.spinner import run_with_spinner
 
 app = typer.Typer(help="Research commands for acra.")
 
@@ -53,7 +55,16 @@ def research(
         "profile": profile,
     }
 
-    result = workflow.invoke(state, config={"callbacks": [OmniAgentCallbacks()]})
+    thread_id = str(uuid.uuid4())
+    result = run_with_spinner(
+        workflow.invoke,
+        state,
+        config={
+            "callbacks": [OmniAgentCallbacks()],
+            "configurable": {"thread_id": thread_id},
+        },
+        message="Researching",
+    )
 
     report = format_research_report(result, output_format=format)
 
@@ -66,4 +77,4 @@ def research(
 
     render_panel(report, title="Research Results")
     if json_output:
-        typer.echo(json.dumps(report, indent=2))
+        typer.echo(json.dumps(report, indent=2))

{acra_cli-0.1.3 → acra_cli-0.1.5}/acra/commands/serve.py

@@ -7,7 +7,15 @@ app = typer.Typer(help="Interactive shell for acra.", invoke_without_command=Tru
 
 
 @app.callback()
-def serve(ctx: typer.Context):
+def serve(
+    ctx: typer.Context,
+    party: bool = typer.Option(
+        False,
+        "--party",
+        "--easter-egg",
+        help="Show the rainbow party-mode startup banner.",
+    ),
+):
     """Launch the interactive acra shell."""
     if ctx.invoked_subcommand is None:
-        launch_shell()
+        launch_shell(party=party)

{acra_cli-0.1.3 → acra_cli-0.1.5}/acra/config/profile_manager.py

@@ -10,6 +10,16 @@ CONFIG_DIR = Path.home() / ".acra"
 CONFIG_FILE = CONFIG_DIR / "config.json"
 DEFAULT_PROFILE_NAME = "default"
 
+# Maps provider names to the credential name acra/agents/llm.py actually
+# reads via keyring_manager.get_key(). Ollama is local and needs no key.
+_PROVIDER_KEY_NAMES = {
+    "gemini": "GEMINI_API_KEY",
+    "openai": "OPENAI_API_KEY",
+    "groq": "GROQ_API_KEY",
+    "huggingface_cloud": "HF_API_KEY",
+    "huggingface_local": "HF_API_KEY",
+}
+
 
 def _ensure_config_dir() -> None:
     CONFIG_DIR.mkdir(parents=True, exist_ok=True)
@@ -69,19 +79,31 @@ class ProfileManager:
         api_key = getpass("Provider API key (hidden): ")
         theme = input("Theme (dark-orange/dark-blue/dark-green): ").strip() or "dark-orange"
         workspace = input("Workspace path (default=current directory): ").strip() or os.getcwd()
-        research_keys = {}
         print("Configure research keys. Press enter to skip a source.")
+        research_key_values = {}
         for source in ["web", "github", "docs", "arxiv"]:
             prompt = f"Research {source} API key (if required): "
             value = getpass(prompt) if source != "arxiv" else input(prompt).strip()
-            research_keys[source] = value or None
+            if value:
+                research_key_values[source] = value
+
+        # Secrets are stored via the OS keyring (falling back to a
+        # permission-locked local file when no OS backend is available),
+        # never written into the plaintext profile JSON. See
+        # acra/utils/keyring_manager.py.
+        from acra.utils.keyring_manager import set_key
+
+        provider_key_name = _PROVIDER_KEY_NAMES.get(provider)
+        if api_key and provider_key_name:
+            set_key(provider_key_name, api_key)
+        for source, value in research_key_values.items():
+            set_key(f"research.{source}", value)
 
         profile = {
             "provider": provider,
             "model": model,
             "theme": theme,
             "workspace": workspace,
-            "research_keys": research_keys,
         }
         self.save_profile(profile_name, profile)
-        return profile_name
+        return profile_name