freeai-code 0.1.0__tar.gz

freeai_code-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Free.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.

freeai_code-0.1.0/PKG-INFO

@@ -0,0 +1,109 @@
+Metadata-Version: 2.4
+Name: freeai-code
+Version: 0.1.0
+Summary: Free AI coding assistant — Claude Code alternative
+Author: Free.ai
+License: MIT
+Project-URL: Homepage, https://free.ai
+Project-URL: Repository, https://github.com/nadermx/free-code
+Keywords: ai,coding,assistant,cli,free
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: click>=8.0
+Requires-Dist: rich>=13.0
+Requires-Dist: httpx>=0.25
+Requires-Dist: pyyaml>=6.0
+Requires-Dist: pathspec>=0.11
+Requires-Dist: tiktoken>=0.5
+Dynamic: license-file
+
+# free-code
+
+Free AI coding assistant for your terminal. Powered by [Free.ai](https://free.ai).
+
+## Install
+
+```bash
+pip install free-code
+```
+
+## Quick Start
+
+```bash
+# Interactive coding session in your project directory
+cd your-project/
+free-code
+
+# Ask a one-shot question about your codebase
+free-code ask "How does the auth system work?"
+
+# Execute a task
+free-code run "Add unit tests for the User model"
+
+# Initialize and scan codebase
+free-code init
+```
+
+## Commands
+
+| Command | Description |
+|---------|-------------|
+| `free-code` | Interactive coding session (alias: `free-code chat`) |
+| `free-code ask "question"` | One-shot question about the codebase |
+| `free-code run "task"` | Execute a coding task |
+| `free-code init` | Initialize config, scan codebase |
+| `free-code config` | Show current configuration |
+| `free-code config set key value` | Set a config value |
+| `free-code login` | Authenticate with Free.ai |
+
+## Configuration
+
+Config is stored at `~/.free-code/config.yaml`.
+
+```bash
+# Set your Free.ai token
+free-code config set token sk-free-xxx
+
+# Use your own API key (BYOK)
+free-code config set provider openai
+free-code config set api_key sk-xxx
+
+# Choose a model
+free-code config set model qwen2.5-coder-32b
+
+# Enable safe mode (confirm before file writes)
+free-code config set safe_mode true
+```
+
+### Supported Providers
+
+- **free.ai** (default) — Free tier with daily limits, paid plans for more
+- **openai** — Bring your own OpenAI API key
+- **anthropic** — Bring your own Anthropic API key
+- **google** — Bring your own Google AI API key
+- **openrouter** — Access 300+ models with one key
+
+## Features
+
+- Reads and edits files in your project
+- Shell command execution (with confirmation)
+- Git integration (status, diff, commit, branch)
+- Test runner auto-detection (pytest, jest, go test, cargo test)
+- Streaming output with syntax highlighting
+- Context window optimization
+- .gitignore-aware file discovery
+
+## License
+
+MIT

freeai_code-0.1.0/README.md

@@ -0,0 +1,79 @@
+# free-code
+
+Free AI coding assistant for your terminal. Powered by [Free.ai](https://free.ai).
+
+## Install
+
+```bash
+pip install free-code
+```
+
+## Quick Start
+
+```bash
+# Interactive coding session in your project directory
+cd your-project/
+free-code
+
+# Ask a one-shot question about your codebase
+free-code ask "How does the auth system work?"
+
+# Execute a task
+free-code run "Add unit tests for the User model"
+
+# Initialize and scan codebase
+free-code init
+```
+
+## Commands
+
+| Command | Description |
+|---------|-------------|
+| `free-code` | Interactive coding session (alias: `free-code chat`) |
+| `free-code ask "question"` | One-shot question about the codebase |
+| `free-code run "task"` | Execute a coding task |
+| `free-code init` | Initialize config, scan codebase |
+| `free-code config` | Show current configuration |
+| `free-code config set key value` | Set a config value |
+| `free-code login` | Authenticate with Free.ai |
+
+## Configuration
+
+Config is stored at `~/.free-code/config.yaml`.
+
+```bash
+# Set your Free.ai token
+free-code config set token sk-free-xxx
+
+# Use your own API key (BYOK)
+free-code config set provider openai
+free-code config set api_key sk-xxx
+
+# Choose a model
+free-code config set model qwen2.5-coder-32b
+
+# Enable safe mode (confirm before file writes)
+free-code config set safe_mode true
+```
+
+### Supported Providers
+
+- **free.ai** (default) — Free tier with daily limits, paid plans for more
+- **openai** — Bring your own OpenAI API key
+- **anthropic** — Bring your own Anthropic API key
+- **google** — Bring your own Google AI API key
+- **openrouter** — Access 300+ models with one key
+
+## Features
+
+- Reads and edits files in your project
+- Shell command execution (with confirmation)
+- Git integration (status, diff, commit, branch)
+- Test runner auto-detection (pytest, jest, go test, cargo test)
+- Streaming output with syntax highlighting
+- Context window optimization
+- .gitignore-aware file discovery
+
+## License
+
+MIT

freeai_code-0.1.0/free_code/__init__.py

@@ -0,0 +1,3 @@
+"""Free.ai Coder CLI — Free AI coding assistant."""
+
+__version__ = "0.1.0"

freeai_code-0.1.0/free_code/__main__.py

@@ -0,0 +1,6 @@
+"""Entry point for `python -m free_code`."""
+
+from free_code.cli import main
+
+if __name__ == "__main__":
+    main()

freeai_code-0.1.0/free_code/agent.py

@@ -0,0 +1,262 @@
+"""Local agent loop — plan, execute, observe."""
+
+from __future__ import annotations
+
+import asyncio
+import json
+from pathlib import Path
+from typing import Any, Dict, List, Optional
+
+from rich.console import Console
+from rich.live import Live
+from rich.spinner import Spinner
+from rich.text import Text
+
+from free_code.client import CoderClient
+from free_code.config import load_config
+from free_code.context.repo_map import generate_repo_map
+from free_code.context.window import build_context
+from free_code.tools import TOOL_DEFINITIONS, TOOL_REGISTRY
+from free_code.tools.shell import is_dangerous
+from free_code.ui.terminal import (
+    confirm,
+    print_error,
+    print_markdown,
+    print_tool_call,
+    print_tool_result,
+)
+
+console = Console()
+
+SYSTEM_PROMPT = """\
+You are Free.ai Coder, an expert AI coding assistant running in the user's terminal.
+You have access to their local filesystem and can read, write, and edit files.
+
+## Tools Available
+You can use these tools to help the user:
+- file_read: Read file contents
+- file_write: Write/create files
+- apply_patch: Search/replace edit in a file
+- shell_command: Execute shell commands
+- grep_search: Search for patterns in code
+- git_status, git_diff, git_commit, git_log: Git operations
+- run_tests: Run the project's test suite
+- list_files: List project files
+
+## Guidelines
+- Read files before editing them to understand the full context
+- Make minimal, focused changes
+- Show diffs for significant edits
+- Run tests after making changes when appropriate
+- Use grep_search to find relevant code before making changes
+- Prefer apply_patch over file_write for editing existing files
+- Ask for confirmation before destructive operations
+- Be concise in explanations, verbose in code
+
+When you need to use a tool, respond with a JSON tool call in this format:
+{"tool": "tool_name", "args": {"arg1": "value1"}}
+
+After each tool result, analyze the output and decide the next step.
+When you're done, provide a final summary of what was accomplished.
+"""
+
+MAX_AGENT_STEPS = 30
+
+
+class Agent:
+    """The coding agent — runs a plan/execute/observe loop."""
+
+    def __init__(
+        self,
+        project_root: Path,
+        config: Optional[Dict[str, Any]] = None,
+    ) -> None:
+        self.project_root = project_root.resolve()
+        self.config = config or load_config()
+        self.client = CoderClient(self.config)
+        self.messages: List[Dict[str, str]] = []
+        self.safe_mode = self.config.get("safe_mode", True)
+
+    async def chat(self, user_message: str) -> None:
+        """Process a user message through the agent loop."""
+        # Build context on first message
+        if not self.messages:
+            context, included = build_context(
+                self.project_root,
+                user_message,
+                max_tokens=self.config.get("max_context_tokens", 32000),
+            )
+            system = SYSTEM_PROMPT + f"\n\n## Project Context\n\n{context}"
+        else:
+            system = None
+
+        self.messages.append({"role": "user", "content": user_message})
+
+        for step in range(MAX_AGENT_STEPS):
+            # Get LLM response
+            response_text = await self._get_response(system)
+            system = None  # Only send system on first turn
+
+            if not response_text:
+                break
+
+            # Check for tool calls in the response
+            tool_call = self._extract_tool_call(response_text)
+
+            if tool_call:
+                tool_name = tool_call["tool"]
+                tool_args = tool_call.get("args", {})
+
+                # Print any text before the tool call
+                pre_text = response_text[:response_text.find('{"tool"')].strip()
+                if pre_text:
+                    print_markdown(pre_text)
+
+                # Execute the tool
+                result = await self._execute_tool(tool_name, tool_args)
+
+                if result is None:
+                    # Tool was cancelled by user
+                    self.messages.append({
+                        "role": "assistant",
+                        "content": response_text,
+                    })
+                    self.messages.append({
+                        "role": "user",
+                        "content": "(Tool execution cancelled by user)",
+                    })
+                    continue
+
+                # Add assistant message and tool result
+                self.messages.append({
+                    "role": "assistant",
+                    "content": response_text,
+                })
+                self.messages.append({
+                    "role": "user",
+                    "content": f"[Tool result for {tool_name}]:\n{result}",
+                })
+            else:
+                # No tool call — this is the final response
+                print_markdown(response_text)
+                self.messages.append({
+                    "role": "assistant",
+                    "content": response_text,
+                })
+                break
+
+    async def _get_response(self, system: Optional[str] = None) -> str:
+        """Get a streaming response from the LLM."""
+        chunks: List[str] = []
+        spinner = Spinner("dots", text="Thinking...")
+
+        with Live(spinner, console=console, refresh_per_second=10, transient=True):
+            first_chunk = True
+            async for event in self.client.chat_stream(self.messages, system=system):
+                event_type = event.get("type", "")
+
+                if event_type == "text":
+                    content = event.get("content", "")
+                    if first_chunk:
+                        first_chunk = False
+                    chunks.append(content)
+
+                elif event_type == "error":
+                    print_error(event.get("content", "Unknown error"))
+                    return ""
+
+                elif event_type == "done":
+                    break
+
+        return "".join(chunks)
+
+    def _extract_tool_call(self, text: str) -> Optional[Dict[str, Any]]:
+        """Extract a tool call JSON from the response text."""
+        # Look for {"tool": "..."} pattern
+        start = text.find('{"tool"')
+        if start == -1:
+            return None
+
+        # Find the matching closing brace
+        depth = 0
+        for i in range(start, len(text)):
+            if text[i] == "{":
+                depth += 1
+            elif text[i] == "}":
+                depth -= 1
+                if depth == 0:
+                    try:
+                        data = json.loads(text[start:i + 1])
+                        if "tool" in data:
+                            return data
+                    except json.JSONDecodeError:
+                        pass
+                    break
+        return None
+
+    async def _execute_tool(
+        self,
+        tool_name: str,
+        tool_args: Dict[str, Any],
+    ) -> Optional[str]:
+        """Execute a tool and return the result. Returns None if cancelled."""
+        if tool_name not in TOOL_REGISTRY:
+            return f"Error: Unknown tool: {tool_name}"
+
+        # Safety checks
+        if self.safe_mode:
+            if tool_name in ("file_write", "apply_patch", "git_commit"):
+                print_tool_call(tool_name, tool_args)
+                if not confirm("Apply this change?"):
+                    return None
+
+            if tool_name == "shell_command":
+                cmd = tool_args.get("command", "")
+                print_tool_call(tool_name, tool_args)
+                if is_dangerous(cmd):
+                    console.print("[warning]This command could be dangerous.[/warning]")
+                if not confirm(f"Run: {cmd}"):
+                    return None
+        else:
+            # Even in non-safe mode, confirm dangerous shell commands
+            if tool_name == "shell_command" and is_dangerous(tool_args.get("command", "")):
+                print_tool_call(tool_name, tool_args)
+                if not confirm("This command could be dangerous. Run anyway?"):
+                    return None
+
+        if tool_name not in ("file_write", "apply_patch", "shell_command", "git_commit") or not self.safe_mode:
+            print_tool_call(tool_name, tool_args)
+
+        # Inject project root
+        tool_args["_project_root"] = str(self.project_root)
+
+        # Execute
+        func = TOOL_REGISTRY[tool_name]
+        try:
+            result = func(**tool_args)
+        except TypeError as e:
+            # Handle unexpected keyword arguments
+            tool_args_clean = {k: v for k, v in tool_args.items() if not k.startswith("_")}
+            tool_args_clean["_project_root"] = str(self.project_root)
+            try:
+                result = func(**tool_args_clean)
+            except Exception as e2:
+                result = f"Error executing {tool_name}: {e2}"
+        except Exception as e:
+            result = f"Error executing {tool_name}: {e}"
+
+        print_tool_result(result, collapsed=len(str(result)) > 1000)
+        return str(result)
+
+    def clear_history(self) -> None:
+        """Clear conversation history."""
+        self.messages.clear()
+
+    def compact_history(self) -> None:
+        """Summarize conversation to save context."""
+        if len(self.messages) <= 2:
+            return
+        # Keep first and last 4 messages, summarize the middle
+        kept = self.messages[:1] + self.messages[-4:]
+        summary = f"(Previous conversation with {len(self.messages)} messages was compacted)"
+        self.messages = [{"role": "user", "content": summary}] + kept

freeai_code-0.1.0/free_code/auth.py

@@ -0,0 +1,74 @@
+"""Authentication flow for Free.ai and BYOK providers."""
+
+from __future__ import annotations
+
+import sys
+from typing import Optional
+
+from rich.console import Console
+from rich.prompt import Prompt
+
+from free_code.config import load_config, save_config, set_config_value
+
+console = Console()
+
+
+def check_auth(config: Optional[dict] = None) -> bool:
+    """Check if the user has valid authentication configured."""
+    if config is None:
+        config = load_config()
+    provider = config.get("provider", "free.ai")
+    if provider == "free.ai":
+        # Free.ai allows anonymous usage with daily limits
+        return True
+    # BYOK providers need an API key
+    return bool(config.get("api_key"))
+
+
+def login_flow() -> None:
+    """Interactive login flow."""
+    config = load_config()
+    console.print()
+    console.print("[bold]Free.ai Coder — Login[/bold]")
+    console.print()
+
+    provider = Prompt.ask(
+        "Provider",
+        choices=["free.ai", "openai", "anthropic", "google", "openrouter"],
+        default="free.ai",
+    )
+
+    if provider == "free.ai":
+        console.print()
+        console.print("Free.ai offers free daily limits with no account required.")
+        console.print("For higher limits, get a token at [link=https://free.ai/pricing]https://free.ai/pricing[/link]")
+        console.print()
+        token = Prompt.ask("Free.ai token (press Enter to skip)", default="")
+        if token:
+            set_config_value("token", token)
+            console.print("[green]Token saved.[/green]")
+        else:
+            console.print("[dim]Using free anonymous tier.[/dim]")
+        set_config_value("provider", "free.ai")
+    else:
+        console.print()
+        key_name = "API key"
+        if provider == "openrouter":
+            console.print("Get an API key at [link=https://openrouter.ai/keys]https://openrouter.ai/keys[/link]")
+        elif provider == "openai":
+            console.print("Get an API key at [link=https://platform.openai.com/api-keys]https://platform.openai.com/api-keys[/link]")
+        elif provider == "anthropic":
+            console.print("Get an API key at [link=https://console.anthropic.com/settings/keys]https://console.anthropic.com/settings/keys[/link]")
+        elif provider == "google":
+            console.print("Get an API key at [link=https://aistudio.google.com/apikey]https://aistudio.google.com/apikey[/link]")
+
+        api_key = Prompt.ask(f"\n{key_name}")
+        if not api_key:
+            console.print("[red]API key is required for {provider}.[/red]")
+            sys.exit(1)
+
+        set_config_value("provider", provider)
+        set_config_value("api_key", api_key)
+        console.print(f"[green]Configured {provider} provider.[/green]")
+
+    console.print("[green]Login complete. Run [bold]free-code[/bold] to start coding.[/green]")