---
language:
- code
pipeline_tag: text-generation
tags:
- code
license: llama2
---
# **Opencsg-stable-code-3b-v1** [[中文]](#chinese) [[English]](#english)
[OpenCSG Community] [github] [wechat] [Twitter]
OpenCSG stands for Converged resources, Software refinement, and Generative LM. The 'C' represents Converged resources, indicating the integration and full utilization of hybrid resources. The 'S' stands for Software refinement, signifying software that is refined by large models. The 'G' represents Generative LM, which denotes widespread, inclusive, and democratized generative large models.
The vision of OpenCSG is to empower every industry, every company, and every individual to own their models. We adhere to the principles of openness and open source, making the large model software stack of OpenCSG available to the community. We welcome everyone to use, send feedback, and contribute collaboratively.
## Model Description
stable-code-3b is a decoder-only language model with 2.7 billion parameters, pre-trained on 1.3 trillion tokens of diverse textual and code datasets. The model is trained on 18 programming languages, selected based on the 2023 StackOverflow Developer Survey.
It demonstrates state-of-the-art performance, compared to models of similar size, across multiple programming languages tested using BigCode's Evaluation Harness.
opencsg-stable-code-3b-v1 is a model based on stable-code-3b that have been fine-tuned using full-parameter tuning methods.
This is the repository for the base 3B version finetuned based on [stable-code-3b](https://huggingface.co/stabilityai/stable-code-3b).
| Model Size | Base Model |
| --- | ----------------------------------------------------------------------------- |
| 3B |[opencsg/Opencsg-stable-coder-3b-v1](https://huggingface.co/opencsg/opencsg-stable-code-3b-v1)|
| opencsg-phi-2-v0.1 | [opencsg/Opencsg-phi-2-v0.1](https://huggingface.co/opencsg/opencsg-phi-2-v0.1) |
## Model Eval
HumanEval is the most common code generation benchmark for evaluating model performance, especially on the compeltion of code exercise cases.
Model evaluation is, to some extent, a metaphysics. Different models have different sensitivities to decoding methods, parameters and instructions.
It is impratical for us to manually set specific configurations for each fine-tuned model, because a real LLM should master general capabilities despite the parameters being manipulated by users.
Therefore, OpenCSG racked their brains to provide a relatively fair method to compare the fine-tuned models on the HumanEval benchmark.
To simplify the comparison, we chosed the Pass@1 metric for the Python language, but our fine-tuning dataset includes samples in multiple languages.
**For fairness, we evaluated the original and fine-tuned stable-code-3b models based only on the prompts from the original cases, without including any other instructions.**
**Besides, we use the greedy decoding method for each model during evaluation.**
| Model | HumanEval python pass@1 |
| --- |----------------------------------------------------------------------------- |
| stable-coder-3b | 29.3%|
| **opencsg-stable-coder-3b-v1**| **46.3%** |
| phi-2 | 48.2% |
| **opencsg-phi-2-v0.1** |**54.3%**|
**TODO**
- We will provide more benchmark scores on fine-tuned models in the future.
- We will provide different practical problems to evaluate the performance of fine-tuned models in the field of software engineering.
# Model Usage
```
import torch
from transformers import AutoModelForCausalLM, AutoTokenizer
tokenizer = AutoTokenizer.from_pretrained("opencsg/opencsg-stable-coder-3b-v1")
model = AutoModelForCausalLM.from_pretrained(
"opencsg/opencsg-stable-coder-3b-v1",
torch_dtype="auto",
)
model.cuda()
inputs = tokenizer("import torch\nimport torch.nn as nn", return_tensors="pt").to(model.device)
tokens = model.generate(
**inputs,
max_new_tokens=48,
temperature=0.2,
do_sample=True,
)
print(tokenizer.decode(tokens[0], skip_special_tokens=True))
```
# Training
## Hardware
- **GPUs:** 8 Tesla A800
- **Training time:** 4 hours
## Software
- **Orchestration:** [Deepspeed](https://github.com/OpenCSGs)
- **Neural networks:** [PyTorch](https://github.com/pytorch/pytorch)
- **BP16 if applicable:** [apex](https://github.com/NVIDIA/apex)
# OpenCSG介绍
[OpenCSG 社区] [github] [微信] [推特]
OpenCSG中 Open是开源开放；C 代表 Converged resources，整合和充分利用的混合异构资源优势，算力降本增效；S 代表 Software refined，重新定义软件的交付方式，通过大模型驱动软件开发，人力降本增效；G 代表 Generative LM，大众化、普惠化和民主化的可商用的开源生成式大模型。
OpenCSG的愿景是让每个行业、每个公司、每个人都拥有自己的模型。 我们坚持开源开放的原则，将OpenCSG的大模型软件栈开源到社区，欢迎使用、反馈和参与共建，欢迎关注。
## 模型介绍
stable-code-3b是一个拥有27亿参数的解码器语言模型，使用了13000亿个多样化文本和代码数据令牌进行预训练。
该模型训练了18种编程语言，在使用BigCode的评估工具测试的多种编程语言上，表现出与相似规模模型相比的最新性能。
opencsg-stable-code-3b-v1是基于stable-code-3b的通过全参数微调方法进行调优的模型。
这是基于 [stable-code-3b](https://huggingface.co/stabilityai/stable-code-3b) 进行微调的模型版本。
| 模型大小 | 基座模型 |
| --- | ----------------------------------------------------------------------------- |
| 3B|[opencsg/Opencsg-stable-coder-3b-v1](https://huggingface.co/opencsg/opencsg-stable-code-3b-v1)|
| opencsg-phi-2-v0.1 | [opencsg/Opencsg-phi-2-v0.1](https://huggingface.co/opencsg/opencsg-phi-2-v0.1) |
## 模型评估
HumanEval 是评估模型在代码生成方面性能的最常见的基准，尤其是在代码习题的补全方面。
模型评估在某种程度上是一种玄学。不同的模型对解码方法、参数和指令的敏感度不同，
优秀的大模型是具备通用能力的，而不会因为解码参数的调整使得模型的生成表现有很大的差异。
因此，OpenCSG 提供了一个相对公平的方法来在 HumanEval 基准上比较各微调模型。
方便起见，我们选择了Python语言Pass@1指标，但要注意的是，我们的微调数据集是包含多种编程语言。
**为了公平起见，我们仅根据原始问题的提示来评估原始和微调过的 stable-code-3b 模型，不包含任何其他说明。**
**除此之外，我们在评估过程中对每个模型都使用贪婪解码方法。**
| 模型 | HumanEval python pass@1 |
| --- |----------------------------------------------------------------------------- |
| stable-coder-3b | 29.3%|
| **opencsg-stable-coder-3b-v1**| **46.3%** |
| phi-2 | 48.2% |
| **opencsg-phi-2-v0.1** |**54.3%**|
**TODO**
- 未来我们将提供更多微调模型的在各基准上的分数。
- 我们将提供不同的实际问题来评估微调模型在软件工程领域的性能。
# 模型使用
```
import torch
from transformers import AutoModelForCausalLM, AutoTokenizer
tokenizer = AutoTokenizer.from_pretrained("opencsg/opencsg-stable-coder-3b-v1")
model = AutoModelForCausalLM.from_pretrained(
"opencsg/opencsg-stable-coder-3b-v1",
torch_dtype="auto",
)
model.cuda()
inputs = tokenizer("import torch\nimport torch.nn as nn", return_tensors="pt").to(model.device)
tokens = model.generate(
**inputs,
max_new_tokens=48,
temperature=0.2,
do_sample=True,
)
print(tokenizer.decode(tokens[0], skip_special_tokens=True))
```
# 训练
## 硬件资源
- **GPU数量：** 8 Tesla A800
- **训练时间：** 4 小时
## 软件使用
- **微调训练框架：** [Deepspeed](https://github.com/OpenCSGs)
- **深度学习框架：** [PyTorch](https://github.com/pytorch/pytorch)
- **BP16：** [apex](https://github.com/NVIDIA/apex) ![[wechat]](https://cdn-uploads.huggingface.co/production/uploads/64c71b27d43e4dee51a8b31a/HU6vz21qKTEmUBCWqCFh9.jpeg){kind=link}