Skip to content

Commit 0fe577d

Browse files
danbarraponcedeleonch
authored andcommittedDec 17, 2024·
Update readme, contrib, and security guides
- Update README to current info - Remove outdated install script - Style & formatting updates - markdownlint fixes
1 parent 1f1a476 commit 0fe577d

File tree

6 files changed

+223
-393
lines changed

6 files changed

+223
-393
lines changed
 

‎CONTRIBUTING.md

+61-30
Original file line numberDiff line numberDiff line change
@@ -1,49 +1,80 @@
1+
# Contributing to CodeGate <!-- omit from toc -->
12

2-
# Contributing to codegate
3-
First off, thank you for taking the time to contribute to codegate! :+1: :tada: codegate is released under the Apache 2.0 license. If you would like to contribute something or want to hack on the code, this document should help you get started. You can find some hints for starting development in codegate's [README](https://github.com/stacklok/codegate/blob/main/README.md).
3+
First off, thank you for taking the time to contribute to CodeGate! :+1: :tada:
4+
CodeGate is released under the Apache 2.0 license. If you would like to
5+
contribute something or want to hack on the code, this document should help you
6+
get started. You can find some hints for starting development in CodeGate's
7+
[README](https://github.com/stacklok/codegate/blob/main/README.md).
48

5-
## Table of contents
6-
- [Code of Conduct](#code-of-conduct)
7-
- [Reporting Security Vulnerabilities](#reporting-security-vulnerabilities)
8-
- [How to Contribute](#how-to-contribute)
9+
## Table of contents <!-- omit from toc -->
10+
11+
- [Code of conduct](#code-of-conduct)
12+
- [Reporting security vulnerabilities](#reporting-security-vulnerabilities)
13+
- [How to contribute](#how-to-contribute)
914
- [Using GitHub Issues](#using-github-issues)
10-
- [Not sure how to start contributing...](#not-sure-how-to-start-contributing)
11-
- [Pull Request Process](#pull-request-process)
15+
- [Not sure how to start contributing?](#not-sure-how-to-start-contributing)
16+
- [Pull request process](#pull-request-process)
1217
- [Contributing to docs](#contributing-to-docs)
13-
- [Commit Message Guidelines](#commit-message-guidelines)
18+
- [Commit message guidelines](#commit-message-guidelines)
19+
20+
## Code of conduct
1421

15-
## Code of Conduct
16-
This project adheres to the [Contributor Covenant](https://github.com/stacklok/codegate/blob/main/CODE_OF_CONDUCT.md) code of conduct. By participating, you are expected to uphold this code. Please report unacceptable behavior to code-of-conduct@stacklok.dev.
22+
This project adheres to the
23+
[Contributor Covenant](https://github.com/stacklok/codegate/blob/main/CODE_OF_CONDUCT.md)
24+
code of conduct. By participating, you are expected to uphold this code. Please
25+
report unacceptable behavior to
26+
[code-of-conduct@stacklok.dev](mailto:code-of-conduct@stacklok.dev).
1727

18-
## Reporting Security Vulnerabilities
28+
## Reporting security vulnerabilities
1929

20-
If you think you have found a security vulnerability in codegate please DO NOT disclose it publicly until we’ve had a chance to fix it. Please don’t report security vulnerabilities using GitHub issues; instead, please follow this [process](https://github.com/stacklok/codegate/blob/main/SECURITY.md)
30+
If you think you have found a security vulnerability in CodeGate please DO NOT
31+
disclose it publicly until we've had a chance to fix it. Please don't report
32+
security vulnerabilities using GitHub issues; instead, please follow this
33+
[process](https://github.com/stacklok/codegate/blob/main/SECURITY.md)
2134

22-
## How to Contribute
35+
## How to contribute
2336

2437
### Using GitHub Issues
25-
We use GitHub issues to track bugs and enhancements. If you have a general usage question, please ask in [CodeGate's discussion forum](https://discord.com/invite/RkzVuTp3WK).
2638

27-
If you are reporting a bug, please help to speed up problem diagnosis by providing as much information as possible. Ideally, that would include a small sample project that reproduces the problem.
39+
We use GitHub issues to track bugs and enhancements. If you have a general usage
40+
question, please ask in
41+
[CodeGate's discussion forum](https://discord.gg/stacklok).
42+
43+
If you are reporting a bug, please help to speed up problem diagnosis by
44+
providing as much information as possible. Ideally, that would include a small
45+
sample project that reproduces the problem.
46+
47+
### Not sure how to start contributing?
2848

29-
### Not sure how to start contributing...
30-
PRs to resolve existing issues are greatly appreciated and issues labeled as ["good first issue"](https://github.com/stacklok/codegate/issues?q=is%3Aopen+is%3Aissue+label%3A%22good+first+issue%22) are a great place to start!
49+
PRs to resolve existing issues are greatly appreciated and issues labeled as
50+
["good first issue"](https://github.com/stacklok/codegate/issues?q=is%3Aopen+is%3Aissue+label%3A%22good+first+issue%22)
51+
are a great place to start!
3152

32-
### Pull Request Process
33-
* Create an issue outlining the fix or feature.
34-
* Fork the codegate repository to your own GitHub account and clone it locally.
35-
* Hack on your changes.
36-
* Correctly format your commit messages, see [Commit Message Guidelines](#Commit-Message-Guidelines) below.
37-
* Open a PR by ensuring the title and its description reflect the content of the PR.
38-
* Ensure that CI passes, if it fails, fix the failures.
39-
* Every pull request requires a review from the core CodeGate team before merging.
40-
* Once approved, all of your commits will be squashed into a single commit with your PR title.
53+
### Pull request process
54+
55+
- Create an issue outlining the fix or feature.
56+
- Fork the CodeGate repository to your own GitHub account and clone it locally.
57+
- Hack on your changes.
58+
- Correctly format your commit messages, see
59+
[Commit message guidelines](#commit-message-guidelines) below.
60+
- Open a PR by ensuring the title and its description reflect the content of the
61+
PR.
62+
- Ensure that CI passes, if it fails, fix the failures.
63+
- Every pull request requires a review from the core CodeGate team before
64+
merging.
65+
- Once approved, all of your commits will be squashed into a single commit with
66+
your PR title.
4167

4268
### Contributing to docs
43-
Follow [this guide](https://github.com/stacklok/codegate/blob/main/docs/README.md) for instructions on building, running, and previewing codegate's documentation.
4469

45-
### Commit Message Guidelines
46-
We follow the commit formatting recommendations found on [Chris Beams' How to Write a Git Commit Message article](https://chris.beams.io/posts/git-commit/):
70+
Follow
71+
[this guide](https://github.com/stacklok/codegate-docs/blob/main/README.md) for
72+
instructions on building, running, and previewing CodeGate's documentation.
73+
74+
### Commit message guidelines
75+
76+
We follow the commit formatting recommendations found on
77+
[Chris Beams' How to Write a Git Commit Message article](https://chris.beams.io/posts/git-commit/):
4778

4879
1. Separate subject from body with a blank line
4980
1. Limit the subject line to 50 characters

‎README.md

+45-70
Original file line numberDiff line numberDiff line change
@@ -1,10 +1,12 @@
11
<picture>
22
<source media="(prefers-color-scheme: dark)" srcset="./static/codegate-logo-white.svg">
3-
<img alt="CodeGate logo" src="./static/codegate-logo-white.svg" width="800px" style="max-width: 100%;">
3+
<img alt="CodeGate logo" src="./static/codegate-logo-dark.svg" width="800px" style="max-width: 100%;">
44
</picture>
55

66
[![CI](https://github.com/stacklok/codegate/actions/workflows/ci.yml/badge.svg)](https://github.com/stacklok/codegate/actions/workflows/ci.yml)
77

8+
## Introduction
9+
810
CodeGate is a local gateway that makes AI coding assistants safer. CodeGate
911
ensures AI-generated recommendations adhere to best practices, while
1012
safeguarding your code's integrity, and protecting your individual privacy. With
@@ -17,12 +19,15 @@ CodeGate is developed by [Stacklok](https://stacklok.com), a group of security
1719
experts with many years of experience building developer friendly open source
1820
security software tools and platforms.
1921

22+
Check out the CodeGate **[website](https://codegate.ai)** and
23+
**[documentation](https://docs.codegate.ai)** to learn more.
24+
2025
## Experimental 🚧
2126

22-
CodeGate is **experimental** and **undergoing fast iterations of development**.
27+
CodeGate is in active development and subject to **rapid change**.
2328

2429
- Features may change frequently
25-
- Expect possible bugs
30+
- Expect possible bugs and breaking changes
2631
- Contributions, feedback, and testing are highly encouraged and welcomed!
2732

2833
## ✨ Why CodeGate?
@@ -38,20 +43,27 @@ your development process by:
3843

3944
## 🌟 Features
4045

41-
### Supported AI providers
46+
### Supported AI coding assistants and providers
47+
48+
CodeGate works with multiple development environments and AI providers.
4249

43-
CodeGate works seamlessly with leading AI providers:
50+
- **[GitHub Copilot](https://github.com/features/copilot)** with Visual Studio
51+
Code and JetBrains IDEs
4452

45-
- 🤖 Anthropic (Claude)
46-
- 🧠 OpenAI
47-
- ⚡ vLLM
48-
- 💻 Local LLMs (run AI completely offline!)
49-
- 🔮 Many more on the way!
53+
- **[Continue](https://www.continue.dev/)** with Visual Studio Code and
54+
JetBrains IDEs
5055

51-
### AI coding assistants
56+
With Continue, you can choose from several leading AI model providers:
5257

53-
We're starting with Continue VS Code extension support, with many more AI coding
54-
assistants coming soon!
58+
- 💻 Local LLMs with [Ollama](https://ollama.com/) and
59+
[llama.cpp](https://github.com/ggerganov/llama.cpp) (run AI completely
60+
offline!)
61+
-[vLLM](https://docs.vllm.ai/en/latest/) (OpenAI-compatible mode, including
62+
OpenRouter)
63+
- 🤖 [Anthropic API](https://www.anthropic.com/api)
64+
- 🧠 [OpenAI API](https://openai.com/api/)
65+
66+
🔮 Many more on the way!
5567

5668
### Privacy first
5769

@@ -65,75 +77,36 @@ at its core:
6577

6678
## 🚀 Quickstart
6779

68-
### Prerequisites
69-
70-
Make sure you have these tools installed:
80+
Check out the quickstart guides to get up and running quickly!
7181

72-
- 🐳 [Docker](https://docs.docker.com/get-docker/)
73-
- 🛠️ [jq](https://stedolan.github.io/jq/download/)
74-
- 💻 [VS Code](https://code.visualstudio.com/download)
75-
76-
### One-command setup
77-
78-
```bash
79-
chmod +x install.sh && ./install.sh
80-
```
81-
82-
This script will:
83-
84-
1. Install the Continue VS Code extension
85-
2. Set up your configuration
86-
3. Create and start necessary Docker services
82+
- [Quickstart guide for GitHub Copilot with VS Code](https://docs.codegate.ai/quickstart)
83+
- [Quickstart guide for Continue with VS Code and Ollama](https://docs.codegate.ai/quickstart-continue)
8784

8885
## 🎯 Usage
8986

90-
### VS Code integration with Continue
87+
### IDE integration
9188

92-
Simply tap the Continue button in your VS Code editor to start chatting with
89+
Simply open the Continue or Copilot chat in your IDE to start interacting with
9390
your AI assistant - now protected by CodeGate!
9491

95-
![Continue chat interface](./static/image.png)
96-
97-
### Manual configuration
98-
99-
#### Basic server start
100-
101-
```bash
102-
codegate serve
103-
```
104-
105-
#### Custom settings
106-
107-
```bash
108-
codegate serve --port 8989 --host localhost --log-level DEBUG
109-
```
110-
111-
#### Using config file
112-
113-
Create a `config.yaml`:
114-
115-
```yaml
116-
port: 8989
117-
host: "localhost"
118-
log_level: "DEBUG"
119-
```
92+
<picture>
93+
<source media="(prefers-color-scheme: dark)" srcset="./static/continue-extension-dark.webp">
94+
<img alt="Continue chat in VS Code" src="./static/continue-extension-light.webp" width="720px" style="max-width: 100%;">
95+
</picture>
12096

121-
Then run:
97+
Refer to the CodeGate docs for more information:
12298

123-
```bash
124-
codegate serve --config config.yaml
125-
```
99+
- [Using CodeGate](https://docs.codegate.ai/how-to)
100+
- [CodeGate features](https://docs.codegate.ai/features)
126101

127-
#### Environment variables
102+
## 🛠️ Development
128103

129-
```bash
130-
export CODEGATE_APP_PORT=8989
131-
export CODEGATE_APP_HOST=localhost
132-
export CODEGATE_APP_LOG_LEVEL=DEBUG
133-
codegate serve
134-
```
104+
Check out the developer reference guides:
135105

136-
## 🛠️ Development
106+
- [Development guide](./docs/development.md)
107+
- [CLI commands and flags](./docs/cli.md)
108+
- [Configuration system](./docs/configuration.md)
109+
- [Logging system](./docs/logging.md)
137110

138111
### Local setup
139112

@@ -217,6 +190,8 @@ docker run -p 8989:8989 -p 9090:80 -e CODEGATE_OLLAMA_URL=http://1.2.3.4:11434/a
217190
We welcome contributions! Whether it's bug reports, feature requests, or code
218191
contributions, please feel free to contribute to making CodeGate better.
219192

193+
Start by reading the [Contributor Guidelines](./CONTRIBUTING.md).
194+
220195
## 📜 License
221196

222197
This project is licensed under the terms specified in the [LICENSE](LICENSE)

0 commit comments

Comments
 (0)
Please sign in to comment.