Consolidate scripts into 4 main workflow scripts

[codegen-sh]

Summary

Successfully consolidated redundant bash scripts into 4 clean, functional workflow scripts that are fully tested and working.

What Changed

Replaced multiple redundant scripts with 4 main scripts:

1. setup.sh - Full Program Setup

• Installs uv package manager if not present
• Installs Python dependencies using Python 3.11
• Creates .env configuration file with sensible defaults
• Prepares database initialization

2. start.sh - Start Configured Server

• Verifies setup completion
• Starts FastAPI server with Granian
• Provides URLs for admin panel and API docs

3. send_request.sh - API Testing

• Waits for server readiness
• Tests non-streaming chat completions
• Tests streaming responses
• Tests models list endpoint
• Provides colored output with test results

4. all.sh - Complete Workflow

• Orchestrates full workflow: setup → start → test
• Runs server in background with logging
• Executes all tests automatically
• Handles cleanup on exit

Technical Fixes

Fixed critical Python version compatibility issues:

• ✅ Explicitly uses Python 3.11 via uv sync --python /usr/bin/python3.11
• ✅ Runs with .venv/bin/python directly (no activation needed)
• ✅ Clears PYTHONPATH to prevent sys.path conflicts with Python 3.13

Testing Results

All scripts tested successfully with Z.AI authentication:

export ZAI_EMAIL="developer@pixelium.uk"
export ZAI_PASSWORD="developer1?"
bash scripts/all.sh

Test Output

✅ Server started successfully on port 8080
✅ Non-streaming chat completion: PASSED
✅ Streaming chat completion: PASSED
✅ Models list retrieval: PASSED

Available Models:

• GLM-4.5, GLM-4.5-Thinking, GLM-4.5-Search, GLM-4.5-Air
• GLM-4.6, GLM-4.6-Thinking, GLM-4.6-Search
• MBZUAI-IFM/K2-Think
• LongCat, LongCat-Flash, LongCat-Search

Usage

# Full workflow (recommended for first time)
bash scripts/all.sh

# Individual scripts
bash scripts/setup.sh       # Setup only
bash scripts/start.sh       # Start server
bash scripts/send_request.sh # Test API

Files Changed

• Added: scripts/all.sh (3.1KB)
• Added: scripts/send_request.sh (4.8KB)
• Added: scripts/setup.sh (2.3KB)
• Added: scripts/start.sh (1.1KB)

---

💻 View my work • 👤 Initiated by @Zeeeepa • About Codegen
⛔ Remove Codegen from PR • 🚫 Ban action checks

---

Summary by cubic

Consolidated many bash scripts into four simple workflow scripts (setup, start, test, all) to streamline local setup, running, and testing. Ensures a consistent Python 3.11 runtime and reduces setup errors.

• New Features

  • setup.sh: Installs uv deps with Python 3.11 and creates a .env with sensible defaults.
  • start.sh: Starts the FastAPI server with helpful URLs.
  • send_request.sh: Runs basic API tests (non-streaming, streaming, models).
  • all.sh: One command to setup → start → test with logging and cleanup.

• Bug Fixes

  • Pins Python to 3.11 via uv sync.
  • Runs with .venv/bin/python and clears PYTHONPATH to avoid 3.13 path conflicts.

[coderabbitai]

Important

Review skipped

Bot user detected.

To trigger a single review, invoke the @coderabbitai review command.

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Note

Other AI code review bot(s) detected

CodeRabbit has detected other AI code review bot(s) in this pull request and will avoid duplicating their findings in the review comments. This may lead to a less comprehensive review.

---

_{Comment @coderabbitai help to get the list of available commands and usage tips.}

[cubic-dev-ai]

2 issues found across 4 files

Prompt for AI agents (all 2 issues)

Understand the root cause of the following 2 issues and fix them.


<file name="scripts/setup.sh">

<violation number="1" location="scripts/setup.sh:34">
Hardcoding `/usr/bin/python3.11` makes `uv sync` fail on machines without that interpreter (common on macOS and many Linux distros), aborting setup under `set -e`. Please detect the interpreter dynamically or fall back gracefully.</violation>
</file>

<file name="scripts/start.sh">

<violation number="1" location="scripts/start.sh:21">
This dependency check should abort when either the virtual environment or the uv lockfile is missing; otherwise the server attempts to run without installed dependencies.</violation>
</file>

_{React with 👍 or 👎 to teach cubic. Mention @cubic-dev-ai to give feedback, ask questions, or re-run the review.}

[cubic-dev-ai]

Hardcoding /usr/bin/python3.11 makes uv sync fail on machines without that interpreter (common on macOS and many Linux distros), aborting setup under set -e. Please detect the interpreter dynamically or fall back gracefully.

Prompt for AI agents

Address the following comment on scripts/setup.sh at line 34:

<comment>Hardcoding `/usr/bin/python3.11` makes `uv sync` fail on machines without that interpreter (common on macOS and many Linux distros), aborting setup under `set -e`. Please detect the interpreter dynamically or fall back gracefully.</comment>

<file context>
@@ -0,0 +1,77 @@
+
+# Install Python dependencies
+echo -e &quot;${YELLOW}📦 Installing Python dependencies with Python 3.11...${NC}&quot;
+uv sync --python /usr/bin/python3.11
+echo -e &quot;${GREEN}✅ Dependencies installed${NC}&quot;
+
</file context>

✅ Addressed in 4d52055

[cubic-dev-ai]

This dependency check should abort when either the virtual environment or the uv lockfile is missing; otherwise the server attempts to run without installed dependencies.

Prompt for AI agents

Address the following comment on scripts/start.sh at line 21:

<comment>This dependency check should abort when either the virtual environment or the uv lockfile is missing; otherwise the server attempts to run without installed dependencies.</comment>

<file context>
@@ -0,0 +1,39 @@
+    exit 1
+fi
+
+if [ ! -d .venv ] &amp;&amp; [ ! -f uv.lock ]; then
+    echo -e &quot;${RED}❌ Error: Dependencies not installed. Run setup first:${NC}&quot;
+    echo -e &quot;   ${YELLOW}bash scripts/setup.sh${NC}&quot;
</file context>

Suggested change

	if [ ! -d .venv ] && [ ! -f uv.lock ]; then
	if [ ! -d .venv ] || [ ! -f uv.lock ]; then