Skip to main content

aman_llm

aman_llm is a simple Python package that enables AI-powered file and shell operations using Google's Gemini API. It uses agent-based logic to interpret natural language instructions and perform system-level tasks like creating files, navigating directories, and more — all powered by LLMs.


🚀 Installation

pip install aman_llm

🔐 Environment Setup

To use aman_llm, you must provide a Gemini API key.

Step 1: Get Your Gemini API Key

Visit the following URL and generate your API key:

👉 https://aistudio.google.com/app/apikey

Step 2: Create a .env File

In your project root, create a .env file and add the following:

GOOGLE_API_KEY=your-gemini-api-key-here

This key will be used to authenticate with Gemini when calling the LLM.


✅ Example Usage

from aman_llm import llm_call

llm_call("Create a file named 'integer.txt' and write numbers 1 to 10 in it", stream=True)

📂 Features

  • ✅ Create and modify text files using AI
  • ✅ Run shell commands like ls, pwd, mkdir, etc.
  • ✅ Delegate tasks between intelligent agents (File & Shell)
  • ✅ Powered by Google's gemini-2.0-flash model
  • ✅ Stream responses with rich markdown output

✨ Coming Soon

  • More tool integrations (e.g. web scraping, PDF generation)
  • Async version of the LLM interface
  • LangChain-style chaining

📜 License

MIT License


👨‍💻 Created By

Aman Prasad
🔗 Connect on LinkedIn

Metadata

Release files for aman-llm 0.1.6

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for aman-llm 0.1.6
File Size Uploaded Provenance Actions
aman_llm-0.1.6.tar.gz 4.4 kB Without provenance Details for aman_llm-0.1.6.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for aman-llm 0.1.6
File Interpreter ABI Platform Actions
aman_llm-0.1.6-py3-none-any.whl Python 3 none any Details for aman_llm-0.1.6-py3-none-any.whl

Total release size: 9.2 kB

Release files / aman_llm-0.1.6.tar.gz

Download URL aman_llm-0.1.6.tar.gz
Size 4.4 kB
Tags Source
SHA-256 checksum
How to use checksums
8da4d90cdb079ab42810dd0523c60f634a7531b34db2c66989f8bf29907f7198
BLAKE2b-256 checksum
How to use checksums
11bee6fc2d9d2bd38ad3a19b167f11e5368089868327a82bea2107449081f33d
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.1.0 CPython/3.12.3

Release files / aman_llm-0.1.6-py3-none-any.whl

Download URL aman_llm-0.1.6-py3-none-any.whl
Size 4.8 kB
Tags Python 3
SHA-256 checksum
How to use checksums
48ce493c8a4994bbf8a1f9c60b1bb04a49b9939d4a49d474e7bc0701c7a3d807
BLAKE2b-256 checksum
How to use checksums
b56fff061d882c626f7eeaadd27738c829e7240dee047094082adef8fc6743d6
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.1.0 CPython/3.12.3

Security for aman-llm 0.1.6

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page