Metadata-Version: 2.1
Name: eigengen
Version: 0.1.7
Summary: EigenGen is a CLI LLM frontend for code generation with support for claude, gpt4 and llama3.1:70b.
Home-page: https://github.com/lleukkun/eigengen
Author: Lauri Leukkunen
Author-email: lauri.leukkunen@gmail.com
License: MIT
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Requires-Python: >=3.6
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: annotated-types ==0.7.0
Requires-Dist: anthropic ==0.34.2
Requires-Dist: anyio ==4.4.0
Requires-Dist: certifi ==2024.8.30
Requires-Dist: charset-normalizer ==3.3.2
Requires-Dist: colorama ==0.4.6
Requires-Dist: distro ==1.9.0
Requires-Dist: fastapi ==0.114.2
Requires-Dist: filelock ==3.16.0
Requires-Dist: fsspec ==2024.9.0
Requires-Dist: google-ai-generativelanguage ==0.6.9
Requires-Dist: google-api-core ==2.19.2
Requires-Dist: google-api-python-client ==2.144.0
Requires-Dist: google-auth ==2.34.0
Requires-Dist: google-auth-httplib2 ==0.2.0
Requires-Dist: google-generativeai ==0.8.0
Requires-Dist: googleapis-common-protos ==1.65.0
Requires-Dist: groq ==0.11.0
Requires-Dist: h11 ==0.14.0
Requires-Dist: httpcore ==1.0.5
Requires-Dist: httpx ==0.27.2
Requires-Dist: huggingface-hub ==0.24.6
Requires-Dist: idna ==3.8
Requires-Dist: jiter ==0.5.0
Requires-Dist: msgpack ==1.1.0
Requires-Dist: openai ==1.44.1
Requires-Dist: packaging ==24.1
Requires-Dist: pydantic ==2.9.1
Requires-Dist: pydantic-core ==2.23.3
Requires-Dist: pyperclip ==1.9.0
Requires-Dist: prompt-toolkit ==3.0.48
Requires-Dist: PyYAML ==6.0.2
Requires-Dist: requests ==2.32.3
Requires-Dist: setuptools ==74.1.2
Requires-Dist: sniffio ==1.3.1
Requires-Dist: tokenizers ==0.20.0
Requires-Dist: tqdm ==4.66.5
Requires-Dist: typing-extensions ==4.12.2
Requires-Dist: urllib3 ==2.2.2
Requires-Dist: uvicorn ==0.30.6

EigenGen
========

EigenGen is a CLI Large Language Model frontend. It is geared towards working with code,
and supports a code review flow where you request changes and review patches suggested
by the tool similar to classic email based patch review.

EigenGen works with 
  - Anthropic claude-3-5-sonnet
  - OpenAI o1-preview, o1-mini, GPT4o
  - Google Gemini 1.5 pro 002
  - llama3.2:90b via Groq

## Features

  - Basic prompt/answer flow with -p "Type your prompt here"
  - Diff output mode with -d that prints out the changes to files as a diff
  - Code Review flow with -r that gives you the option to continue discussing the changes with the LLM
    by typing your comments in-line with '> ' quoted diff. This is a bit like software development used to be before Pull Requests.
  - Add 'git ls-files' files to context automatically with -g, filtered by .eigengen_ignore.
  - eigengen -g --index creates an index cache in .eigengen_cache for semi-automatic context detection. When
    using -g switch after creating the index, eigengen includes any locally modified files as determined by git
    plus any files listed with -f argument, and then further adds those files that reference symbols defined in
    this list of files. Performance is good enough to work with pytorch repo, but linux kernel is still a bit too much,
    having a 12 second index cache load time. This would indicate that thousands of files are ok, but tens of thousands
    require patience. Rewriting the cache logic in C/C++/Rust/Zig would probably help but design must be validated
    more first.


## Installation
```
pip install eigengen
```

You must export your API key using:
```
export ANTHROPIC_API_KEY=<your-api-key>
or
export OPENAI_API_KEY=<your-api-key>
or
export GROQ_API_KEY=<your-api-key>
or
export GOOGLE_API_KEY=<your-api-key>
```

## Tips

  - In addition to `eigengen` executable, we provide `egg` as well. It's shorter.
  - EigenGen uses `EDITOR` environment variable to pick the text editor.
  - Combining the two, for Sublime Text you can: `alias egg='EDITOR="subl -w" egg -m gpt4'`
  - Or if you're into VSCode: `alias egg='EDITOR="code -w" egg -m gpt4'`.
  - Vim/Neovim/Emacs users can probably figure out their own solutions.
  - Paths above are for Linux. MacOS and Windows binaries may not be in PATH, so you need to find them first.

## Development

Please install in edit mode like this:
```
python3 -m venv .venv
. .venv/bin/activate
pip install -e .
```

For testing install pytest.


## Example Usage

```
# start a new code review flow to develop a TODO-list web app
eigengen -r -g -p "Please implement a TODO-list web app using react + javascript, thank you. Provide the full project directory structure, please. It should allow adding, editing and deleting entries."

# pipe file content in through stdin
cat setup.py | eigengen -f - -p "Please review the given source file, thank you!"

# pipe a git diff output and write a review for it
git diff origin/main^^..HEAD | eigengen -f - -p "Please write a code review for the given diff, thank you!
```

By default eigengen uses claude-3-5-sonnet. In order to use OpenAI GPT4o model, please give --model, -m argument
like this:
```
eigengen -m gpt4 -p "your prompt content"
```

You may wish to create a shell alias to avoid having to type it in all the time:
```
alias eigengen='eigengen -m gpt4'
```

## Work In Progress
  - HTTP API interface

## TODO:
  - Figure out why Mistral's models just hate our prompts.

