semvec/pypi-packages huggingface dataset:
pan-insights-sdk 0.2.1
Python SDK for Palo Alto Networks Prisma Access Insights 3.0 API
License: MIT
Requires Python: >=3.10

# Prisma Access Insights SDK

Python SDK and CLI for querying the Palo Alto Networks Prisma Access Insights 3.0 API.

Query users, applications, sites, and security events from your Prisma Access deployment for reporting, monitoring, and analytics.

## Installation

### pip

```bash
pip install pan-insights-sdk
```

### Docker

```bash
docker build -t insights .
docker run --rm insights --help
```

### From source

```bash
git clone https://github.com/ancoleman/insights-sdk-cli.git
cd insights-sdk-cli
make dev
```

See [Installation Guide](docs/installation.md) for all options and CI/CD setup.

## Quick Start

### 1. Set Credentials

```bash
export SCM_CLIENT_ID=your-service-account@tsg.iam.panserviceaccount.com
export SCM_CLIENT_SECRET=your-secret
export SCM_TSG_ID=your-tsg-id
```

### 2. CLI Usage

```bash
insights test                    # Test connection
insights users list agent        # List users (last 24h)
insights users count agent       # Connected user count
insights apps list               # List applications
insights sites traffic           # Site traffic
insights --help                  # All commands
```

### 3. Python SDK

```python
from insights_sdk import InsightsClient

with InsightsClient(
    client_id="your-client-id",
    client_secret="your-secret",
    tsg_id="your-tsg-id",
) as client:
    users = client.get_agent_users(hours=24)
    print(f"Found {len(users.get('data', []))} users")
```

## Documentation

| Guide | Description |
|-------|-------------|
| [Installation](docs/installation.md) | pip, Docker, source, and CI/CD setup |
| [CLI Reference](docs/cli-reference.md) | Complete command reference |
| [SDK Guide](docs/sdk-guide.md) | Python SDK usage and filtering |

## Command Groups

| Group | Description |
|-------|-------------|
| `insights users` | User queries (list, count, sessions, devices) |
| `insights apps` | Application queries |
| `insights sites` | Site queries |
| `insights security` | PAB security events |
| `insights monitoring` | Monitored user metrics |
| `insights accelerated` | Accelerated app metrics |

## Development

```bash
make help       # Show all targets
make dev        # Install with dev deps
make test       # Run tests
make lint       # Run linters
make format     # Format code
make build      # Build Docker image
```

## License

MIT
push-to-whisper 0.1.1
Yet another voice memo tool
License: MIT
Requires Python: >=3.11

# push-to-whisper

A smart voice memo tool aka **`push-to-stt-to-md-to-llm-to-clipboard-or-whatever`.**

![](./assets/how_it_works.png)

### What you can do with push-to-whisper:

- **Record** audio while holding a global key combination.
- **Save** the recording as a `.wav` file (e.g., directly into your Obsidian vault).
- **Transcode** it into `.ogg` or other formats for efficiency (via ffmpeg).
- **Transcribe** it into Markdown using Whisper (Currently supports `whisper.cpp` server).
- **Refine** the text using LLM APIs like OpenAI, Gemini, or Ollama (via LiteLLM).
  - Auto tagging, auto summarization, etc.
- **Copy** the result to your clipboard automatically.
- **Notify** success or send results to notification services like Slack, Discord, or Ntfy (via Apprise).

Every step above is modular. You can combine them to build your own custom workflow in a simple YAML configuration file.

## Installation

1. Install system dependencies:
   ```bash
   # Debian/Ubuntu
   sudo apt install libgirepository1.0-dev libcairo2-dev python3-dev ffmpeg
   ```

2. Install the package using `uv`:
   ```bash
   uv tool install push-to-whisper
   ```

3. Install the systemd user service and generate a default config:
   ```bash
   push-to-whisper install-daemon
   ```

## Configuration

The configuration file is located at `~/.config/push-to-whisper/config.yaml`. You can customize the Whisper endpoint, LLM API keys (LiteLLM), and processing pipelines.

To re-initialize or export the default configuration:
```bash
push-to-whisper init --bare -o ~/.config/push-to-whisper/config.yaml
```

## Usage

Once the daemon is installed via `install-daemon`, it will start automatically on login.

### Default Shortcuts

On Linux (KDE/GNOME), shortcuts are managed by the system. After running `install-daemon`, you can assign keys to the following actions in your system settings:

- **Transcription to Markdown**: (Recommended: `ALT+SHIFT+x`) - Transcribe -> Transcode -> Save Audio -> Save Markdown -> Notify.
- **Transcription to Clipboard**: (Recommended: `ALT+SHIFT+c`) - Transcribe -> Transcode -> Copy to Clipboard -> Notify.

*Note: Currently tested and supported only on Linux (Fedora) with KDE Plasma (Wayland). Native support for Windows and macOS is planned for future releases.*

## Development

- **Formatting**: `uv run ruff format .`
- **Linting**: `uv run ruff check . --fix`
- **Testing**: `uv run pytest`

## License

MIT