quantalogic 0.92__tar.gz → 0.93__tar.gz

{quantalogic-0.92 → quantalogic-0.93}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: quantalogic
-Version: 0.92
+Version: 0.93
 Summary: QuantaLogic ReAct Agents
 License: MIT
 Author: Raphaël MANSUY
@@ -125,57 +125,86 @@ Here’s how it flows:
 ```mermaid
 graph TD
     A[User] -->|Input| B[QuantaLogic]
-    B --> C[ReAct: Solve]
+    B --> C1[Pure ReAct]
+    B --> C2[CodeAct]
     B --> D[Flow: Automate]
     B --> E[Chat: Converse]
-    C --> F[LLM + Tools]
+    C1 --> F1[LLM + Tools]
+    C2 --> F2[LLM + Code Actions]
     D --> G[Nodes + Engine]
     E --> H[Persona + Tools]
-    F --> I[Output]
+    F1 --> I[Output]
+    F2 --> I
     G --> I
     H --> I
     I --> A
-    style A fill:#f0f,stroke:#333
-    style I fill:#aaf,stroke:#333
+    style A fill:#ffe5b4,stroke:#555
+    style B fill:#cfe0e8,stroke:#555
+    style C1 fill:#e6e6fa,stroke:#555
+    style C2 fill:#ffd1dc,stroke:#555
+    style D fill:#c8e6c9,stroke:#555
+    style E fill:#fff9c4,stroke:#555
+    style F1 fill:#f0f0f0,stroke:#555
+    style F2 fill:#f0f0f0,stroke:#555
+    style G fill:#d0f0c0,stroke:#555
+    style H fill:#ffefdb,stroke:#555
+    style I fill:#cfe0e8,stroke:#555
 ```
 
+For detailed CodeAct documentation, see [CodeAct Module](quantalogic_codeact/README.md).
+
 ---
 
 ## How to Get Started
 
 **How do you dive in?** Install it, set it up, and start creating. We’ll guide you through setup, examples, and pro tips to master QuantaLogic in minutes.
 
-### Installation
+### Installation & Setup
 
-#### What You Need
-- **Python 3.12+**: The fuel for our AI engine.
-- **Docker** (optional): For secure tool execution.
+#### Prerequisites
+- Python >= 3.10+ (required)
+- Docker (optional; sandboxed execution)
+- Poetry (optional; for source builds)
 
-#### Option 1: pip (Fast Track)
+#### Installation
+Install the core CLI and (optionally) CodeAct extension:
 ```bash
 pip install quantalogic
+pip install quantalogic-codeact
 ```
-
-#### Option 2: pipx (Clean Setup)
+Or with pipx:
 ```bash
 pipx install quantalogic
+pipx install quantalogic-codeact
 ```
 
-#### Option 3: Source (For Hackers)
+#### Developer Build (optional)
 ```bash
 git clone https://github.com/quantalogic/quantalogic.git
 cd quantalogic
 python -m venv .venv
-source .venv/bin/activate  # Windows: .venv\Scripts\activate
+# macOS/Linux
+source .venv/bin/activate
+# Windows
+.venv\\Scripts\\activate
 poetry install
 ```
 
-**Insider Secret**: Create a `.env` file for API keys to unlock LLMs:
+#### Verify Installation
 ```bash
-echo "OPENAI_API_KEY=sk-your-key" > .env
-echo "DEEPSEEK_API_KEY=ds-your-key" >> .env
+quantalogic --help
+quantalogic_codeact --help
 ```
 
+#### Configure API Keys
+```bash
+cat <<EOF > .env
+OPENAI_API_KEY=sk-your-key
+DEEPSEEK_API_KEY=ds-your-key
+EOF
+```
+> For advanced settings, see [docs/config.md](./docs/config.md)
+
 ---
 
 ### Quick Start Examples
@@ -194,6 +223,16 @@ quantalogic chat --persona "You’re a cosmic guide" "What’s the tallest mount
 ```
 **Output**: A lively response, possibly with search results!
 
+#### CLI: CodeAct Shell
+```bash
+quantalogic_codeact shell
+```
+
+#### CLI: CodeAct Task
+```bash
+quantalogic_codeact task "Solve 2 + 2" --model deepseek/deepseek-chat --timeout 60 --streaming
+```
+
 #### Python: ReAct Agent
 ```python
 from quantalogic import Agent
@@ -396,18 +435,6 @@ result = agent.solve_task("Write a poem")
 
 **Memory Magic**: Imagine a sticky note board. As tasks or chats grow, QuantaLogic condenses old notes to keep space for new ones—efficient and clutter-free.
 
----
-
-### Example Playground
-Dive into our [Examples Folder](./examples/) for inspiration:
-- **Code Generation**: [05-code.py](./examples/05-code.py)
-- **Workflow Demo**: [story_generator_agent.py](./examples/flow/story_generator/story_generator_agent.py)
-- **Finance Tasks**: [10-finance-agent.py](./examples/10-finance-agent.py)
-
-**Video Walkthrough**:
-[![Demo Video](./examples/generated_tutorials/python/quantalogic_long.mp4)](./examples/generated_tutorials/python/quantalogic_long.mp4)
-
----
 
 ### Contributing
 

{quantalogic-0.92 → quantalogic-0.93}/README.md

@@ -62,57 +62,86 @@ Here’s how it flows:
 ```mermaid
 graph TD
     A[User] -->|Input| B[QuantaLogic]
-    B --> C[ReAct: Solve]
+    B --> C1[Pure ReAct]
+    B --> C2[CodeAct]
     B --> D[Flow: Automate]
     B --> E[Chat: Converse]
-    C --> F[LLM + Tools]
+    C1 --> F1[LLM + Tools]
+    C2 --> F2[LLM + Code Actions]
     D --> G[Nodes + Engine]
     E --> H[Persona + Tools]
-    F --> I[Output]
+    F1 --> I[Output]
+    F2 --> I
     G --> I
     H --> I
     I --> A
-    style A fill:#f0f,stroke:#333
-    style I fill:#aaf,stroke:#333
+    style A fill:#ffe5b4,stroke:#555
+    style B fill:#cfe0e8,stroke:#555
+    style C1 fill:#e6e6fa,stroke:#555
+    style C2 fill:#ffd1dc,stroke:#555
+    style D fill:#c8e6c9,stroke:#555
+    style E fill:#fff9c4,stroke:#555
+    style F1 fill:#f0f0f0,stroke:#555
+    style F2 fill:#f0f0f0,stroke:#555
+    style G fill:#d0f0c0,stroke:#555
+    style H fill:#ffefdb,stroke:#555
+    style I fill:#cfe0e8,stroke:#555
 ```
 
+For detailed CodeAct documentation, see [CodeAct Module](quantalogic_codeact/README.md).
+
 ---
 
 ## How to Get Started
 
 **How do you dive in?** Install it, set it up, and start creating. We’ll guide you through setup, examples, and pro tips to master QuantaLogic in minutes.
 
-### Installation
+### Installation & Setup
 
-#### What You Need
-- **Python 3.12+**: The fuel for our AI engine.
-- **Docker** (optional): For secure tool execution.
+#### Prerequisites
+- Python >= 3.10+ (required)
+- Docker (optional; sandboxed execution)
+- Poetry (optional; for source builds)
 
-#### Option 1: pip (Fast Track)
+#### Installation
+Install the core CLI and (optionally) CodeAct extension:
 ```bash
 pip install quantalogic
+pip install quantalogic-codeact
 ```
-
-#### Option 2: pipx (Clean Setup)
+Or with pipx:
 ```bash
 pipx install quantalogic
+pipx install quantalogic-codeact
 ```
 
-#### Option 3: Source (For Hackers)
+#### Developer Build (optional)
 ```bash
 git clone https://github.com/quantalogic/quantalogic.git
 cd quantalogic
 python -m venv .venv
-source .venv/bin/activate  # Windows: .venv\Scripts\activate
+# macOS/Linux
+source .venv/bin/activate
+# Windows
+.venv\\Scripts\\activate
 poetry install
 ```
 
-**Insider Secret**: Create a `.env` file for API keys to unlock LLMs:
+#### Verify Installation
 ```bash
-echo "OPENAI_API_KEY=sk-your-key" > .env
-echo "DEEPSEEK_API_KEY=ds-your-key" >> .env
+quantalogic --help
+quantalogic_codeact --help
 ```
 
+#### Configure API Keys
+```bash
+cat <<EOF > .env
+OPENAI_API_KEY=sk-your-key
+DEEPSEEK_API_KEY=ds-your-key
+EOF
+```
+> For advanced settings, see [docs/config.md](./docs/config.md)
+
 ---
 
 ### Quick Start Examples
@@ -131,6 +160,16 @@ quantalogic chat --persona "You’re a cosmic guide" "What’s the tallest mount
 ```
 **Output**: A lively response, possibly with search results!
 
+#### CLI: CodeAct Shell
+```bash
+quantalogic_codeact shell
+```
+
+#### CLI: CodeAct Task
+```bash
+quantalogic_codeact task "Solve 2 + 2" --model deepseek/deepseek-chat --timeout 60 --streaming
+```
+
 #### Python: ReAct Agent
 ```python
 from quantalogic import Agent
@@ -333,18 +372,6 @@ result = agent.solve_task("Write a poem")
 
 **Memory Magic**: Imagine a sticky note board. As tasks or chats grow, QuantaLogic condenses old notes to keep space for new ones—efficient and clutter-free.
 
----
-
-### Example Playground
-Dive into our [Examples Folder](./examples/) for inspiration:
-- **Code Generation**: [05-code.py](./examples/05-code.py)
-- **Workflow Demo**: [story_generator_agent.py](./examples/flow/story_generator/story_generator_agent.py)
-- **Finance Tasks**: [10-finance-agent.py](./examples/10-finance-agent.py)
-
-**Video Walkthrough**:
-[![Demo Video](./examples/generated_tutorials/python/quantalogic_long.mp4)](./examples/generated_tutorials/python/quantalogic_long.mp4)
-
----
 
 ### Contributing
 

{quantalogic-0.92 → quantalogic-0.93}/pyproject.toml

@@ -1,6 +1,6 @@
 [tool.poetry]
 name = "quantalogic"
-version = "0.92"
+version = "0.93"
 description = "QuantaLogic ReAct Agents"
 authors = ["Raphaël MANSUY <raphael.mansuy@gmail.com>"]
 readme = "README.md"