doushi-cli 0.1.0__tar.gz

doushi_cli-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Doushi AI
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

doushi_cli-0.1.0/PKG-INFO

@@ -0,0 +1,236 @@
+Metadata-Version: 2.4
+Name: doushi-cli
+Version: 0.1.0
+Summary: Official CLI for Doushi.ai - Instant Autonomous ML Modeling from your Terminal
+Author-email: Doushi AI Team <support@doushi.ai>
+License: MIT
+Keywords: machine-learning,ai,cli,automl,doushi,developer-tools
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: typer[all]>=0.12.0
+Requires-Dist: rich>=13.7.0
+Requires-Dist: httpx>=0.27.0
+Requires-Dist: pydantic>=2.0.0
+Requires-Dist: python-dotenv>=1.0.0
+Dynamic: license-file
+
+# Doushi AI CLI (`doushi` / `dsh`) Specification & Architecture
+
+The official command-line interface for **Doushi.ai** — empowering developers and data teams to build, train, inspect, and deploy autonomous ML models directly from their terminal.
+
+---
+
+## 1. Vision & Core Philosophy
+
+- **Zero-Boilerplate ML**: Go from a local dataset CSV to a production-ready hosted inference model with a single command.
+- **Developer-First UX**: Beautiful terminal UI with spinners, rich colored tables, streaming agent logs, and shell completions.
+- **Unix-Philosophy Compliant**: Full support for piping (`cat test.csv | doushi predict <id> | jq`), stdout redirection, and JSON outputs (`--json`).
+- **No Vendor Lock-In**: One command (`doushi export`) downloads the raw scikit-learn/XGBoost/LightGBM code, Dockerfile, FastAPI microservice, and trained weights (`model.pkl`).
+
+---
+
+## 2. Authentication & Browser Sign-In Workflow
+
+```mermaid
+sequenceDiagram
+    autonumber
+    actor User
+    participant CLI as Doushi CLI (Terminal)
+    participant Browser as Web Browser
+    participant Web as Doushi Web App (doushi.ai)
+    participant API as Doushi Backend API
+
+    User->>CLI: doushi login
+    CLI->>CLI: Bind local HTTP server on random port (e.g. 54321)<br/>Generate cryptographic state token
+    CLI->>Browser: Open https://doushi.ai/cli/auth?port=54321&state=XYZ
+    Browser->>Web: Load CLI Authorization Page
+    Note over Web,Browser: User logs in if session is expired
+    Web->>User: "Authorize Doushi CLI to access your account?"
+    User->>Web: Clicks "Authorize CLI"
+    Web->>API: POST /api/api-keys (name: "CLI - Hostname")
+    API-->>Web: Returns API Key { key: "dsh_live_...", org_id, email }
+    Web->>Browser: Redirect to http://localhost:54321/callback?key=dsh_live_...&state=XYZ
+    Browser->>CLI: GET /callback with API Key & state
+    CLI->>CLI: Validate state nonce, write credentials to ~/.doushi/credentials
+    CLI-->>Browser: HTTP 200: "Authorization Successful! Return to terminal."
+    CLI->>CLI: Terminate local HTTP server
+    CLI->>User: ✔ Logged in as user@domain.com
+```
+
+### Auth Modes:
+1. **Interactive Browser Login (Default)**:
+   ```bash
+   doushi login
+   ```
+   Opens `https://doushi.ai/cli/auth?port=<port>&state=<nonce>` and catches the callback automatically.
+
+2. **Headless / Remote SSH Server (`--no-browser`)**:
+   ```bash
+   doushi login --no-browser
+   ```
+   Outputs an activation URL and one-time verification code (Device Code Flow).
+
+3. **Direct Token / API Key**:
+   ```bash
+   doushi login --key dsh_live_xxxxxxxxxxxxxxxx
+   ```
+   Or set via environment variable:
+   ```bash
+   export DOUSHI_API_KEY="dsh_live_xxxxxxxxxxxxxxxx"
+   ```
+
+4. **Account Inspection & Logout**:
+   ```bash
+   doushi whoami
+   doushi logout
+   ```
+
+---
+
+## 3. Command Hierarchy & Reference
+
+```text
+doushi [OPTIONS] COMMAND [ARGS]...
+
+Authentication:
+  login                 Authenticate CLI with Doushi.ai via browser or API Key
+  logout                Remove local credentials
+  whoami                Show active user, organization, and tier quota
+
+Model Training & Project Management:
+  train, create         Upload dataset and prompt to train an autonomous model
+  init                  Interactive wizard for creating a project step-by-step
+  projects, ls          List all projects, statuses, and performance metrics
+  view <id>             Inspect project details, features, hyperparameters, and confusion matrix
+  delete <id>           Delete a project and its artifacts
+
+Inference & Deployment:
+  predict <id>          Run live prediction via inline JSON, CSV file, or stdin pipe
+  host <id>             Toggle dedicated sub-20ms warm EC2 hosting vs on-demand mode
+  snippet <id>          Generate copy-paste code snippets (cURL, Python, TypeScript, Go)
+
+Agent Observability & Interaction:
+  logs <id> [-f]        Stream real-time training and self-healing agent sandbox logs
+  chat <id>             Interactive terminal REPL to chat with the model agent
+  export <id>           Download model.pkl, training script, Dockerfile, and FastAPI server
+
+Utilities:
+  demo                  Download a sample dataset (churn, housing, fraud) and test immediately
+  completion            Generate shell autocompletion script (bash, zsh, fish)
+  config                Get or set CLI configuration options
+```
+
+---
+
+## 4. Key Workflows & Example Invocations
+
+### A. One-Command Model Training
+```bash
+# Train on customer churn dataset with goal
+doushi train ./churn_data.csv --goal "Predict customer churn probability"
+
+# Train with specific target column override
+doushi train ./housing.csv --goal "Predict house sale price" --target price
+```
+
+### B. Live Agent Streaming
+```bash
+# Stream agent's self-healing loop and sandbox execution in real time
+doushi logs proj_982fa10c -f
+```
+
+### C. Live Predictions
+```bash
+# 1. Single sample JSON
+doushi predict proj_982fa10c --data '{"tenure": 12, "monthly_spend": 79.5, "contract": "Month-to-month"}'
+
+# 2. Batch predict from CSV file
+doushi predict proj_982fa10c --file ./test_users.csv --output ./results.csv
+
+# 3. Unix Pipe
+cat new_records.csv | doushi predict proj_982fa10c | jq '.predictions[]'
+```
+
+### D. Interactive Terminal Chat (Agent REPL)
+```bash
+doushi chat proj_982fa10c
+```
+```text
+🤖 Doushi Assistant (Connected to Project: 'Customer Churn Predictor')
+> What were the top features affecting predictions?
+Agent: 1. monthly_spend (32.4%)
+       2. support_tickets (28.1%)
+       3. tenure_months (18.6%)
+
+> Retrain using LightGBM and handle outliers in monthly_spend
+Agent: Refinement task enqueued. Triggering new sandbox run...
+```
+
+### E. Standalone Code & Model Export
+```bash
+doushi export proj_982fa10c --out ./exported-model/
+```
+**Output Directory Contents:**
+```text
+exported-model/
+├── model.pkl            # Serialized model artifact
+├── pipeline.py          # Scikit-learn / XGBoost training code
+├── requirements.txt     # Locked dependencies
+├── serve.py             # FastAPI microservice for local deployment
+└── Dockerfile           # Production container definition
+```
+
+---
+
+## 5. Local File System & Configuration
+
+```text
+~/.doushi/
+├── credentials        # Mode 0600 file holding active API keys & tokens
+└── config.json        # Global configurations (default endpoint, format, timeouts)
+```
+
+**`~/.doushi/credentials`**:
+```json
+{
+  "current_context": "default",
+  "contexts": {
+    "default": {
+      "user_email": "user@example.com",
+      "user_id": "usr_abc123",
+      "org_id": "org_personal_456",
+      "api_key": "dsh_live_98a7sd8f7a9s8d7f"
+    }
+  }
+}
+```
+
+---
+
+## 6. Implementation Roadmap
+
+### Phase 1: Core CLI Foundation
+- [ ] Initialize Python CLI package with `typer`, `rich`, and `httpx` (or Go standalone binary).
+- [ ] Implement `doushi login` with local loopback HTTP server and browser redirection.
+- [ ] Implement `doushi whoami` and `doushi logout`.
+- [ ] Implement `~/.doushi/credentials` security store.
+
+### Phase 2: Project Lifecycle & Training
+- [ ] Implement `doushi train <file>` with multipart upload, prompt submission, and spinner.
+- [ ] Implement `doushi projects list` with formatted Rich tables.
+- [ ] Implement `doushi view <id>` showing status, metrics, and dataset schema.
+- [ ] Implement `doushi logs <id> -f` for live execution stream.
+
+### Phase 3: Inference & Agent Tools
+- [ ] Implement `doushi predict <id>` (JSON argument, CSV batch, and pipe support).
+- [ ] Implement `doushi chat <id>` interactive REPL session.
+- [ ] Implement `doushi export <id>` to download `model.pkl` + serving boilerplate.
+- [ ] Implement `doushi demo` with embedded sample datasets for instant onboarding.

doushi_cli-0.1.0/README.md

@@ -0,0 +1,150 @@
+# ✦ Doushi AI CLI (`doushi` / `dsh`)
+
+[![PyPI Version](https://img.shields.io/badge/pypi-v0.1.0-blue.svg)](https://pypi.org/project/doushi-cli/)
+[![Python Versions](https://img.shields.io/badge/python-3.10%20%7C%203.11%20%7C%203.12-blue)](https://pypi.org/project/doushi-cli/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT)
+[![Doushi Platform](https://img.shields.io/badge/Platform-Doushi.ai-cyan.svg)](https://doushi.ai)
+
+**The official command-line interface for [Doushi.ai](https://doushi.ai)** — empowering developers, data scientists, and hackers to build, train, inspect, and deploy autonomous machine learning models directly from their terminal.
+
+---
+
+## ✨ Features
+
+- ⚡ **Zero-Boilerplate ML**: Go from raw datasets (`.parquet`, `.xls`, `.xlsx`, `.json`, `.csv`, `.tsv`) to production-ready models in a single command.
+- 🔒 **Security-First Auth**: AWS CLI-style credential management (`~/.doushi/credentials` with strict `0600` permissions).
+- 🛡️ **Pre-Flight Limit Checks**: Validates dataset integrity and file limits locally before uploading.
+- 🔄 **Real-Time Streaming**: Watch the autonomous self-healing agent loop live in your terminal.
+- 🚀 **Live Inference & Pipes**: Predict via inline JSON, batch CSV files, or standard input streams (`cat data.csv | doushi predict <id>`).
+- 📦 **No Vendor Lock-In**: Export raw scikit-learn/XGBoost training code, `model.pkl`, FastAPI microservice, and Dockerfile with `doushi export`.
+
+---
+
+## 📦 Installation
+
+Install via `pip`:
+```bash
+pip install doushi-cli
+```
+
+Or run instantly without installing using `pipx`:
+```bash
+pipx run doushi demo
+```
+
+*(Both `doushi` and `dsh` are available as CLI aliases)*
+
+---
+
+## 🚀 Quickstart in 60 Seconds
+
+### 1. Authenticate your terminal
+```bash
+doushi configure
+```
+*(Prompts for your API key from [doushi.ai/settings/api-keys](https://doushi.ai/settings/api-keys))*
+
+### 2. Try the 30-second instant demo
+```bash
+doushi demo
+```
+*(Trains an autonomous model on a sample customer churn dataset and shows live performance metrics)*
+
+### 3. Train on your own dataset
+```bash
+doushi train ./my_dataset.csv --goal "Predict customer churn probability"
+```
+
+---
+
+## 📖 Command Reference
+
+### Authentication
+```bash
+doushi configure       # Set up API Key & verify credentials
+doushi whoami          # View active organization, plan tier, and project quotas
+doushi logout          # Remove stored local credentials
+```
+
+### Model Training & Projects
+```bash
+# Upload dataset and train with autonomous agent
+doushi train ./dataset.csv --goal "Predict house sale prices"
+
+# List all organization projects and best metrics
+doushi projects list
+
+# Inspect detailed model parameters, KPIs, and dataset preview
+doushi projects view <project_id>
+
+# Delete a project
+doushi projects delete <project_id>
+```
+
+### Predictions & Inference
+```bash
+# 1. Predict with single inline JSON record
+doushi predict <project_id> --data '{"age": 32, "tenure": 12, "balance": 4500.0}'
+
+# 2. Batch predict from a test CSV file
+doushi predict <project_id> --file ./test_records.csv --output ./predictions.csv
+
+# 3. Unix standard input piping
+cat records.csv | doushi predict <project_id> | jq '.predictions[]'
+```
+
+### Observability & Code Export
+```bash
+# Stream real-time agent execution & self-healing sandbox logs
+doushi logs <project_id> -f
+
+# Export standalone model bundle (model.pkl + FastAPI + Dockerfile)
+doushi export <project_id> --out ./model-bundle/
+```
+
+---
+
+## 📂 Exported Model Bundle Structure
+
+Running `doushi export <project_id>` gives you everything you need to run completely independent of Doushi:
+
+```text
+model-bundle/
+├── model.pkl            # Pretrained model weights
+├── pipeline.py          # Complete scikit-learn / XGBoost training script
+├── requirements.txt     # Locked dependencies
+├── serve.py             # FastAPI REST microservice
+├── Dockerfile           # Production container
+└── README.md            # Local deployment instructions
+```
+
+---
+
+## 🛠️ Development & Contributing
+
+### Local Setup
+```bash
+git clone https://github.com/doushi-ai/doushi-cli.git
+cd doushi-cli
+
+python3 -m venv venv
+source venv/bin/activate
+pip install -e ".[dev]"
+```
+
+### Run Test Suite
+```bash
+python3 -m unittest discover -s tests
+```
+
+---
+
+## 📄 License
+
+Distributed under the [MIT License](LICENSE). See `LICENSE` for more information.
+
+---
+
+<p align="center">
+  Built with ✦ by the <a href="https://doushi.ai">Doushi.ai</a> Team
+</p>

doushi_cli-0.1.0/cli.md

@@ -0,0 +1,212 @@
+# Doushi AI CLI (`doushi` / `dsh`) Specification & Architecture
+
+The official command-line interface for **Doushi.ai** — empowering developers and data teams to build, train, inspect, and deploy autonomous ML models directly from their terminal.
+
+---
+
+## 1. Vision & Core Philosophy
+
+- **Zero-Boilerplate ML**: Go from a local dataset CSV to a production-ready hosted inference model with a single command.
+- **Developer-First UX**: Beautiful terminal UI with spinners, rich colored tables, streaming agent logs, and shell completions.
+- **Unix-Philosophy Compliant**: Full support for piping (`cat test.csv | doushi predict <id> | jq`), stdout redirection, and JSON outputs (`--json`).
+- **No Vendor Lock-In**: One command (`doushi export`) downloads the raw scikit-learn/XGBoost/LightGBM code, Dockerfile, FastAPI microservice, and trained weights (`model.pkl`).
+
+---
+
+## 2. Authentication & Browser Sign-In Workflow
+
+```mermaid
+sequenceDiagram
+    autonumber
+    actor User
+    participant CLI as Doushi CLI (Terminal)
+    participant Browser as Web Browser
+    participant Web as Doushi Web App (doushi.ai)
+    participant API as Doushi Backend API
+
+    User->>CLI: doushi login
+    CLI->>CLI: Bind local HTTP server on random port (e.g. 54321)<br/>Generate cryptographic state token
+    CLI->>Browser: Open https://doushi.ai/cli/auth?port=54321&state=XYZ
+    Browser->>Web: Load CLI Authorization Page
+    Note over Web,Browser: User logs in if session is expired
+    Web->>User: "Authorize Doushi CLI to access your account?"
+    User->>Web: Clicks "Authorize CLI"
+    Web->>API: POST /api/api-keys (name: "CLI - Hostname")
+    API-->>Web: Returns API Key { key: "dsh_live_...", org_id, email }
+    Web->>Browser: Redirect to http://localhost:54321/callback?key=dsh_live_...&state=XYZ
+    Browser->>CLI: GET /callback with API Key & state
+    CLI->>CLI: Validate state nonce, write credentials to ~/.doushi/credentials
+    CLI-->>Browser: HTTP 200: "Authorization Successful! Return to terminal."
+    CLI->>CLI: Terminate local HTTP server
+    CLI->>User: ✔ Logged in as user@domain.com
+```
+
+### Auth Modes:
+1. **Interactive Browser Login (Default)**:
+   ```bash
+   doushi login
+   ```
+   Opens `https://doushi.ai/cli/auth?port=<port>&state=<nonce>` and catches the callback automatically.
+
+2. **Headless / Remote SSH Server (`--no-browser`)**:
+   ```bash
+   doushi login --no-browser
+   ```
+   Outputs an activation URL and one-time verification code (Device Code Flow).
+
+3. **Direct Token / API Key**:
+   ```bash
+   doushi login --key dsh_live_xxxxxxxxxxxxxxxx
+   ```
+   Or set via environment variable:
+   ```bash
+   export DOUSHI_API_KEY="dsh_live_xxxxxxxxxxxxxxxx"
+   ```
+
+4. **Account Inspection & Logout**:
+   ```bash
+   doushi whoami
+   doushi logout
+   ```
+
+---
+
+## 3. Command Hierarchy & Reference
+
+```text
+doushi [OPTIONS] COMMAND [ARGS]...
+
+Authentication:
+  login                 Authenticate CLI with Doushi.ai via browser or API Key
+  logout                Remove local credentials
+  whoami                Show active user, organization, and tier quota
+
+Model Training & Project Management:
+  train, create         Upload dataset and prompt to train an autonomous model
+  init                  Interactive wizard for creating a project step-by-step
+  projects, ls          List all projects, statuses, and performance metrics
+  view <id>             Inspect project details, features, hyperparameters, and confusion matrix
+  delete <id>           Delete a project and its artifacts
+
+Inference & Deployment:
+  predict <id>          Run live prediction via inline JSON, CSV file, or stdin pipe
+  host <id>             Toggle dedicated sub-20ms warm EC2 hosting vs on-demand mode
+  snippet <id>          Generate copy-paste code snippets (cURL, Python, TypeScript, Go)
+
+Agent Observability & Interaction:
+  logs <id> [-f]        Stream real-time training and self-healing agent sandbox logs
+  chat <id>             Interactive terminal REPL to chat with the model agent
+  export <id>           Download model.pkl, training script, Dockerfile, and FastAPI server
+
+Utilities:
+  demo                  Download a sample dataset (churn, housing, fraud) and test immediately
+  completion            Generate shell autocompletion script (bash, zsh, fish)
+  config                Get or set CLI configuration options
+```
+
+---
+
+## 4. Key Workflows & Example Invocations
+
+### A. One-Command Model Training
+```bash
+# Train on customer churn dataset with goal
+doushi train ./churn_data.csv --goal "Predict customer churn probability"
+
+# Train with specific target column override
+doushi train ./housing.csv --goal "Predict house sale price" --target price
+```
+
+### B. Live Agent Streaming
+```bash
+# Stream agent's self-healing loop and sandbox execution in real time
+doushi logs proj_982fa10c -f
+```
+
+### C. Live Predictions
+```bash
+# 1. Single sample JSON
+doushi predict proj_982fa10c --data '{"tenure": 12, "monthly_spend": 79.5, "contract": "Month-to-month"}'
+
+# 2. Batch predict from CSV file
+doushi predict proj_982fa10c --file ./test_users.csv --output ./results.csv
+
+# 3. Unix Pipe
+cat new_records.csv | doushi predict proj_982fa10c | jq '.predictions[]'
+```
+
+### D. Interactive Terminal Chat (Agent REPL)
+```bash
+doushi chat proj_982fa10c
+```
+```text
+🤖 Doushi Assistant (Connected to Project: 'Customer Churn Predictor')
+> What were the top features affecting predictions?
+Agent: 1. monthly_spend (32.4%)
+       2. support_tickets (28.1%)
+       3. tenure_months (18.6%)
+
+> Retrain using LightGBM and handle outliers in monthly_spend
+Agent: Refinement task enqueued. Triggering new sandbox run...
+```
+
+### E. Standalone Code & Model Export
+```bash
+doushi export proj_982fa10c --out ./exported-model/
+```
+**Output Directory Contents:**
+```text
+exported-model/
+├── model.pkl            # Serialized model artifact
+├── pipeline.py          # Scikit-learn / XGBoost training code
+├── requirements.txt     # Locked dependencies
+├── serve.py             # FastAPI microservice for local deployment
+└── Dockerfile           # Production container definition
+```
+
+---
+
+## 5. Local File System & Configuration
+
+```text
+~/.doushi/
+├── credentials        # Mode 0600 file holding active API keys & tokens
+└── config.json        # Global configurations (default endpoint, format, timeouts)
+```
+
+**`~/.doushi/credentials`**:
+```json
+{
+  "current_context": "default",
+  "contexts": {
+    "default": {
+      "user_email": "user@example.com",
+      "user_id": "usr_abc123",
+      "org_id": "org_personal_456",
+      "api_key": "dsh_live_98a7sd8f7a9s8d7f"
+    }
+  }
+}
+```
+
+---
+
+## 6. Implementation Roadmap
+
+### Phase 1: Core CLI Foundation
+- [ ] Initialize Python CLI package with `typer`, `rich`, and `httpx` (or Go standalone binary).
+- [ ] Implement `doushi login` with local loopback HTTP server and browser redirection.
+- [ ] Implement `doushi whoami` and `doushi logout`.
+- [ ] Implement `~/.doushi/credentials` security store.
+
+### Phase 2: Project Lifecycle & Training
+- [ ] Implement `doushi train <file>` with multipart upload, prompt submission, and spinner.
+- [ ] Implement `doushi projects list` with formatted Rich tables.
+- [ ] Implement `doushi view <id>` showing status, metrics, and dataset schema.
+- [ ] Implement `doushi logs <id> -f` for live execution stream.
+
+### Phase 3: Inference & Agent Tools
+- [ ] Implement `doushi predict <id>` (JSON argument, CSV batch, and pipe support).
+- [ ] Implement `doushi chat <id>` interactive REPL session.
+- [ ] Implement `doushi export <id>` to download `model.pkl` + serving boilerplate.
+- [ ] Implement `doushi demo` with embedded sample datasets for instant onboarding.

doushi_cli-0.1.0/doushi/__init__.py

@@ -0,0 +1,4 @@
+"""Doushi CLI - Instant Autonomous ML Modeling from your Terminal."""
+
+__version__ = "1.0.0"
+__app_name__ = "doushi"