semvec/pypi-packages huggingface dataset:
gemini-cli-agent 0.1.0
Python wrapper for Google's Gemini CLI agentic capabilities
License: MIT
Requires Python: >=3.11
Keywords: gemini, ai, agent, cli, mcp, google, llm

# Gemini Agent

Python wrapper for [Google's Gemini CLI](https://github.com/google-gemini/gemini-cli) agentic capabilities.

## Installation

```bash
pip install gemini-agent            # client only
pip install gemini-agent[core]      # + direct CLI usage
pip install gemini-agent[server]    # + REST API service
```

**Requirements:** Node.js 18+ and `npm install -g @google/gemini-cli`

## Quick Start

```bash
export GEMINI_API_KEY=your_key
```

```python
from gemini_agent.core import GeminiAgent

agent = GeminiAgent()
result = agent.run("Create a Python CLI that lists files")

print(result.response)        # Gemini's response
print(result.modified_files)  # {"cli.py": "import os..."}
```

## Usage

### Direct CLI Wrapper

```python
from gemini_agent.core import GeminiAgent

agent = GeminiAgent(
    model="gemini-2.5-flash",  # optional
    sandbox=True,              # isolated execution
)

result = agent.run(
    "Build a REST API with FastAPI",
    mcp_servers=["filesystem"],
    files={"spec.txt": "..."},
)

# result.success, result.response, result.modified_files
```

### Python Client (Remote)

```python
from gemini_agent.client import GeminiAgentClient

async with GeminiAgentClient("http://localhost:8000") as client:
    result = await client.run("Create a hello world script")
    print(result.modified_files)
```

### REST API

```bash
podman-compose up -d --build

# Submit task
curl -X POST http://localhost:8000/tasks \
  -H "Content-Type: application/json" \
  -d '{"prompt": "Create a fibonacci function"}'

# Get result
curl http://localhost:8000/tasks/{task_id}
```

## API Endpoints

| Method | Endpoint | Description |
|--------|----------|-------------|
| `POST` | `/tasks` | Submit task |
| `GET` | `/tasks/{id}` | Get result |
| `DELETE` | `/tasks/{id}` | Cancel task |
| `GET` | `/health` | Health check |
| `GET` | `/mcp/servers` | List MCP servers |
| `POST` | `/mcp/servers` | Add MCP server |

## Configuration

| Variable | Description |
|----------|-------------|
| `GEMINI_API_KEY` | API key (required) |
| `GEMINI_MODEL` | Model override |
| `GEMINI_TIMEOUT` | Timeout in seconds (default: 300) |
| `REDIS_URL` | Redis URL for server mode |

## License

MIT
gade 0.2.2
Gradient-Aware Development Environment - Allocate AI compute dynamically based on code difficulty
License: MIT
Requires Python: >=3.11
Keywords: ai, cli, code-analysis, development, llm

# GADE - Gradient-Aware Development Environment

[![Python 3.11+](https://img.shields.io/badge/python-3.11+-blue.svg)](https://www.python.org/downloads/)
[![PyPI](https://img.shields.io/pypi/v/gade.svg)](https://pypi.org/project/gade/)
[![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT)

**Allocate AI compute dynamically based on code difficulty.**

GADE measures difficulty across your codebase and focuses 80% of tokens on the 20% hardest regions.

## Quick Start

```bash
pip install gade

# Analyze a repository (works on all systems)
python -m gade analyze ./my-project --top 20

# View heatmap
python -m gade heatmap ./my-project
```

> **Windows Users:** If `gade` command doesn't work, use `python -m gade` instead. This is the recommended universal approach.

## Cloud API

Use the hosted API — no setup required:

```bash
curl -X POST "https://web-production-8b5ca.up.railway.app/analyze" \
  -H "Content-Type: application/json" \
  -d '{"repo_path": "./my-project", "top_k": 10}'
```

📖 **API Docs:** [web-production-8b5ca.up.railway.app/docs](https://web-production-8b5ca.up.railway.app/docs)

## Features

- **5 Difficulty Signals**: Edit churn, complexity, errors, uncertainty, gradient
- **80/20 Allocation**: Smart token distribution by difficulty
- **Multi-LLM Support**: OpenAI, Anthropic, Google, Ollama, Azure, Bedrock
- **Agentic AI Ready**: MCP server, OpenAI tools, LangChain integration
- **REST API**: Hosted cloud API or self-host

## Installation

```bash
pip install gade
```

## Python SDK

```python
from gade import analyze

result = analyze("./my-project")
for node in result.get_top_k(10):
    print(f"{node.node_name}: {node.difficulty_score:.2f}")
```

## CLI Commands

| Command | Description |
|---------|-------------|
| `python -m gade analyze <path>` | Rank code by difficulty |
| `python -m gade heatmap <path>` | Terminal visualization |
| `python -m gade refactor <path>` | AI-assisted refactoring |

## Difficulty Tiers

| Score | Tier | AI Strategy |
|-------|------|-------------|
| < 0.2 | compress | Summarize |
| 0.2-0.5 | standard | Single-pass |
| 0.5-0.8 | deep | Multi-step + tools |
| ≥ 0.8 | debate | Multi-pass synthesis |

## License

MIT
sphinxcontrib-friendlinks 0.1.2
A Sphinx extension for rendering beautiful friend link cards
License: MIT
Requires Python: >=3.8
Keywords: sphinx, sphinx-extension, friendlinks, blogroll, documentation

# sphinxcontrib-friendlinks

A Sphinx extension for rendering beautiful friend link cards in your documentation.

## Installation

```bash
pip install sphinxcontrib-friendlinks
```

## Usage

Add the extension to your `conf.py`:

```python
extensions = [
    'sphinxcontrib_friendlinks',
]
```

Then use the `friendlink` directive in your reStructuredText files:

```rst
.. friendlink::
   :name: Example Site
   :link: https://example.com
   :avatar: https://example.com/avatar.png
   :descr: This is an example site description
   :siteshot: https://example.com/screenshot.png
   :rss: https://example.com/rss.xml
```

## Options

| Option | Required | Description |
|--------|----------|-------------|
| `name` | Yes | Site name |
| `link` | Yes | Site URL |
| `avatar` | Yes | Avatar image URL |
| `descr` | Yes | Site description |
| `siteshot` | No | Site screenshot URL |
| `rss` | No | RSS feed URL |

## Features

- Clean card-style layout with avatar, name, description
- Optional site screenshot display
- RSS link with icon
- Responsive design for mobile devices
- Dark mode support (`prefers-color-scheme`)
- XSS protection for user input

## Example

![Friend Link Card Example](https://raw.githubusercontent.com/un4gt/sphinxcontrib-friendlinks/main/docs/_build/html/_static/example.png)

## License

MIT