Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/phact/code-assistant

FastHTML app that makes other FastHTML apps with LLMs
https://github.com/phact/code-assistant

assistants-api claude claude-3-5-sonnet fasthtml gpt-4o htmx openai python railway

Last synced: 7 days ago
JSON representation

FastHTML app that makes other FastHTML apps with LLMs

Awesome Lists containing this project

README 

        
# code-assistant



A FastHTML app that makes FastHTML apps.



[![commits](https://img.shields.io/github/commit-activity/m/phact/code-assistant)](https://github.com/phact/code-assistant/commits/main)

[![Github Last Commit](https://img.shields.io/github/last-commit/phact/code-assistant)](https://github.com/phact/code-assistant/commits/main)

[![Release](https://github.com/phact/code-assistant/actions/workflows/releases.yml/badge.svg?branch=main)](https://github.com/phact/code-assistant/actions/workflows/releases.yml)

[![Docker build and publish](https://github.com/phact/code-assistant/actions/workflows/docker.yml/badge.svg)](https://github.com/phact/code-assistant/actions/workflows/docker.yml)

[![PyPI - Downloads](https://img.shields.io/pypi/dw/code-assistant?label=pypi%20downloads)](https://badge.fury.io/py/code-assistant)

[![Dockerhub](https://img.shields.io/static/v1?label=Pull%20from&message=DockerHub&color=blue&logo=Docker&style=flat-square)](https://hub.docker.com/r/phact/code-assistant)

[![Discord chat](https://img.shields.io/static/v1?label=Chat%20on&message=Discord&color=blue&logo=Discord&style=flat-square)](https://discord.gg/MEFVXUvsuy)

[![Stars](https://img.shields.io/github/stars/phact/code-assistant?style=social)](https://github.com/phact/code-assistant/stargazers)



## Features and Roadmap:



### Guiding the LLM

 - [X] LSP support (code actions)

 - [X] LSP support (retrieve diagnostics)

 - [X] LSP Support (linter/formatter with `ruff server`)

 - [ ] LSP Support (type checker, use pyright or wait for ruff red-knot? https://github.com/astral-sh/ruff/issues/12701)

 - [ ] LSP support (use diagnostics in LLM context)

 - [X] Self-healing (backend runtime errors)

 - [X] Self-healing (frontend runtime errors)

 - [X] python indentation helper with tree sitter

 - [X] FastHTML specific validations using ast-grep

 - [X] FastHTML documentation llm context

 - [X] HTMX documentation llm context

 - [ ] fastlite documentation llm context

 - [ ] fastsql documentation llm context

 - [ ] fastastra documentation llm context

 - [ ] dynamic openapi spec llm context

 - [ ] dynamic sample apps llm context

 - [ ] astra-assistants documentation llm context

 - [ ] Multi-file support

 - [ ] Multi-turn generation



### UI/UX

 - [X] Live app preview

 - [X] Drive generated_apps dir with env var CA_GENERATED_APPS_DIR

 - [X] Add third party model support to frontend

 - [X] Improve third party auth

 - [ ] ollama integration guide / docs



 ### Multi-tenancy

 - [ ] Sessions

 - [ ] Sandboxing (probably with e2b)



code-assistant is built on OpenAI's Assistant API and uses astra-assistants to support other models including claude and local models.



## Install and run



Install with pip:



    pip install code-assistant



Run:



    code-assistant



this will start the web server on port 5001 and will create a generated_apps directory on your current working directory. You can override this directory by setting the CA_GENERATED_APPS_DIR environment variable.



    export CA_GENERATED_APPS_DIR="~/my_apps"

    code-assistant



## Run as an isolated program



use pipx or uvx if you're a uv user to run as an isolated program:



    pipx run code-assistant



or



    uvx code-assistant



## Deploy on Railway



[![Deploy on Railway](https://railway.app/button.svg)](https://railway.app/template/uLhG0l?referralCode=A6Uk1R)



**Note**: Deployments on Railway using this template are exposed to the internet. For security the template requires you to set up basic auth (username and password) to protect your deployment. Do not share these with anyone you do not trust.



## Run with Docker



    docker run -p 5001:5001 phact/code-assistant



optionally pass auth credentials as environment variables:



    docker run -p 5001:5001 -e OPENAI_API_KEY="your-key" phact/code-assistant



or 



    docker run -p 5001:5001 -e ANTHROPIC_API_KEY="your-key" -e ASTRA_DB_APPLICATION_TOKEN="your token" phact/code-assistant



etc depending on your LLM provider.



## Third party LLM provider Authentication



If you have not provided credentials via env vars the UI will prompt you for credentials. Credentials inputed via the UI are not persisted.



[![video](assets/code_assistant_models.gif)](https://www.youtube.com/watch?v=9Vk7t7wtd4E)



To avoid manual entry, set up environment variables for [astradb](https://astra.datastax.com/) [required for any non OpenAI models] and your LLM provider of choice.:



```

#!/bin/bash



# AstraDB -> https://astra.datastax.com/ --> tokens --> administrator user --> generate

export ASTRA_DB_APPLICATION_TOKEN=""



# OpenAI Models - https://platform.openai.com/api-keys --> create new secret key

export OPENAI_API_KEY=""



# Groq Models - https://console.groq.com/keys

export GROQ_API_KEY=""



# Anthropic claude models - https://console.anthropic.com/settings/keys

export ANTHROPIC_API_KEY=""



# Gemini models -> https://makersuite.google.com/app/apikey

export GEMINI_API_KEY=""



# Perplexity models -> https://www.perplexity.ai/settings/api  --> generate

export PERPLEXITYAI_API_KEY=""



# Cohere models -> https://dashboard.cohere.com/api-keys

export COHERE_API_KEY=""



# Bedrock models -> https://docs.aws.amazon.com/bedrock/latest/userguide/setting-up.html

export AWS_REGION_NAME=""

export AWS_ACCESS_KEY_ID=""

export AWS_SECRET_ACCESS_KEY=""



# vertexai models https://console.cloud.google.com/vertex-ai

export GOOGLE_JSON_PATH=""

export GOOGLE_PROJECT_ID=""



# ... for other models see https://github.com/datastax/astra-assistants-api/blob/main/.env.bkp

```