#  open-essay-gui

**Repository Path**: open-ai-essay/open-essay-gui

## Basic Information

- **Project Name**:  open-essay-gui
- **Description**: 一款AI自动生成论文的PC客户端软件。 gui基于pywebview。web服务使用flask+vue2。只要能跑python脚本，windows和mac和linux理论上都能用。在win上开发，mac和linux未测试。
- **Primary Language**: Python
- **License**: MulanPSL-2.0
- **Default Branch**: main
- **Homepage**: https://365d.ink
- **GVP Project**: No

## Statistics

- **Stars**: 29
- **Forks**: 10
- **Created**: 2024-06-19
- **Last Updated**: 2025-09-18

## Categories & Tags

**Categories**: Uncategorized

**Tags**: qwen-max, Flask, vue2, AI, autowriteessay

## README

# open-essay-gui
### （Notice：已适配deepseek）
# 0. 致朋友

b站的朋友们，感谢安装使用，如果遇到bug，或者问题，欢迎加入#交流QQ QQ QQ 群 948035049 。

下边是正常运行起来的样子
![启动界面](screenshots/s1.png)
![配置界面](screenshots/s2.png)
![ai批量生成论文标题](screenshots/s4.png)
![ai生成论文提纲](screenshots/s3.png)
![ai对话，验证apikey是否配置正确](screenshots/s5.png)
![ai生成论文内容](screenshots/s6.png)


# 1. OpenEssay 软件介绍

## 1.1 OpenEssay 有什么用？
- 一款AI自动生成论文的PC客户端软件。
只要能跑python脚本，windows和mac和linux理论上都能用。在win上开发，mac和linux未测试。

## 1.2 OpenEssay 具体功能是什么？
- 依赖AI大模型接口，完成辅助论文选题，辅助给出论文提纲，辅助生成论文内容，最后下载得到word版本的已经微调格式的论文。

是神笔写作 https://www.shenbixiezuo.com 的核心功能开源版。
从 www.shenbixiezuo.com 应用中，剥离了账户体系，非核心功能，只留下了 AI论文选题，AI论文提纲，AI论文生成，WORD文档生成的核心功能。(前 https://365d.ink)

## 1.3 OpenEssay 真开源吗？
- 真开源，绝不需要付费，不要授权，任何人自己PC上部署。vue代码和flask代码都是明文状态。

## 1.4 OpenEssay 使用成本是什么？
- 调用AI接口，只需要自己申请一个 “阿里云千问大模型”或者“kimi大模型”的apikey ，两个选1即可。
目前这个两者都有免费的额度，个人写几篇论文，没有丝毫压力。


# 2. 安装教程

[安装教程](/安装说明.md)


# 3. 本软件运行需要win10或者win11。mac&linux理论上无障碍

- 这个非常小的软件，本质是个网站，使用vue2+flask+sqlite搭建。使用了python语言的pywebivew实现gui，运行在win平台上，假装自己是个客户端软件。由于pywebivew的缘故，对运行平台有要求。
            
- 在win11上，可以直接正常打开。

- 在win10上，有可能无法打开。如果能打开窗口，但首页白屏，可试一下安装 微软的 webview 支持包，下载安装即可。地址如下 https://developer.microsoft.com/zh-cn/microsoft-edge/webview2/?form=shenbixiezuo.com.

- 如果是win10之前的系统，可能会有各种各样的问题，比如缺少各种dll，不建议使用了。有开荒的朋友，加群发截图哈。QQ群：948035049
            
- 如果是mac和linux，理论上是没问题的，pywebview 支持这2个平台，但尚未测试过。如果你在这两个平台运行成功了，请务必发个截图到群里。QQ群：948035049

# 4. 什么是 大模型的apikey?

- 本小软件，只是个界面，没有文字内容生成的能力，也不需要显卡[doge]。生成论文内容，需要调用 阿里云千问、kimi、豆包等大厂的AI接口。调用大厂的接口，需要先在大厂的网站，申请一个apikey，也就是访问api的许可证，类似秘钥。每个人的都不一样，是私有的，要自己保密保存。

- 大厂的apikey，都是按生成字数收费的.


- 所以，推荐使用在线版 <a style='color:blue;' target='_blank' href='https://www.ShenBiXieZuo.com'>神笔写作</a> https://www.ShenBiXieZuo.com，神笔写作向大厂购买AI字数。


- 用在线版的 <a style='color:blue;' target='_blank' href='https://www.ShenBiXieZuo.com'>神笔写作</a> https://www.ShenBiXieZuo.com ，向所有的烦恼说拜拜，向所有的水文说嗨嗨！把繁琐的代码、安装、python什么的，都抛给程序员去烦恼吧！


## 4.1 apikey 用完后，要记得删除


- 如题，重要的事情说3遍，3遍，3遍。因为各大厂的apikey免费额度用完后，是要按字数计费的。一般脸小的用户，都是欠费停机。但任然强烈建议，用完之后，在大厂ai管理界面，删除对应的apikey，安全起见。

# 5. 说好的羊毛在哪儿？

- 羊毛就是！

- 截止2024年12月，各大厂的AI接口，都有新用户免费额度，比如阿里云的千问max大模型，新用户开通第一个月，送100w字数。豆包模版，开通送400w字。kimi的apikey首次开通，送100w字。

## 5.1 而，本软件的存在，就是为了这些羊毛而来O(∩_∩)O~


# 6. 如何获取大厂ai的福利apikey？

## 6.1 阿里云新用户送100w免费token

- 首先，登录阿里云官网 https://www.aliyun.com, 手机验证码登录。根据提示用支付宝扫码完成实名（2分钟可完成）。点下边链接，直达阿里云的大模型管理平台。在界面上按提示，新建一个apikey，保存下来即。新用户有免费额度，100wToken。",
- 打开如下地址 https://dashscope.console.aliyun.com/apiKey",
- 官网关于免费的说明：https://help.aliyun.com/zh/dashscope/product-overview/billing-rules",
         
## 6.2 kimi新用户送100w免费token

- 打开kimi开发者官网， 手机号验证码登录，根据提示完成开发者认证。打开下边链接，直达apikey管理界面。新建一个apikey，保存下来。新用户有100wtoken的免费额度。
- 下边传送门直达 https://platform.moonshot.cn/console/api-keys

         
## 6.3 豆包新用户也送很多token

- 打开火山引擎 官网 https://www.volcengine.com/ ， 手机号登录验证后。下边传送门，直接到apikey管理界面，https://console.volcengine.com/ark/region:ark+cn-beijing/apiKey",

- 豆包的接入代码中，除了apikey，还需要配置一个endpoint, 推理接入点，https://www.volcengine.com/docs/82379/1099522。目前被写死到代码中的是一个我自己新建的endpoint，还不能灵活配置。目前不确定endpoint 是私有的还是公有的，如果是私有的，那会导致软件中豆包模型不

-  如果你是源码运行，可以修改这个endpoint, 在/openessay/common/ai/adapter/doubao.py  第 55行
        
## 6.4 关于其他ai模型
         
-  本畜终日刨食不得闲，没有时间适配了。程序猿们有兴趣，大家搞起来,在  /openessay/common/ai/adapter/ 下边实现一个适配即可。 欢迎合并代码。
          
# 7. 不忘初心
         
- 说了这么多，不忘推广在线版 <a style='color:blue;' target='_blank' href='https://www.ShenBiXieZuo.com'>神笔写作</a>。
- /*以下广告：
- 【用神笔写作，跟所有的烦恼说拜拜，跟所有的水文说嗨嗨！秃顶的活儿，就让程序猿们去干吧! 亲，只需要扫码登录，开箱即用! 】
- 让ai绞尽脑汁，我们还是留时间享受生活！
- 神笔写作，新用户送体验字数，邀请朋友送字数，周135送字数,遇到了bug送字数，b站三联送字数。。。送字数，送字数，送字数，就图个开心。
- 感谢大家多多支持哈，本码畜给您旺旺了,不胜感激<(*￣▽￣*)/
            
- 广告完*/
- 最初的最初，网站确实连的chatgpt，尝试性的。后来国内ai发展如火如荼，本土ai比gpt的效果好多了，至少中文论文qianwen-max 比gpt3.5强的明显。神笔写作目前仅使用 通义千问，kimi和豆包，具备工信部备案、公安网联备案。
- 同时，有一个 chatgpt 版本，地址是 <a style='color:blue;' target='_blank' href='https://www.topessay.org'> https://www.topessay.org</a>，仅支持英文环境使用。
         
# 8. 开源精神

- https://www.ShenBiXieZuo 程序员开发了全部第一个版本的代码，并剥离出此开源版本。 
- 本次发布包含前端vue，python，全部代码，禁止用于一切非法用途，禁止用于商业用途。仅可用于热爱祖国热爱人民之用途。
- 感谢 elme-ui，让这个软件不至于丑吐用户！没有elme-ui，这个软件不可能诞生！
- 感谢 b 站！没有b站，这个软件不可能诞生！b站一键三联，送vip1。
- 感谢vue、flask、sqlite大神等等.
            
- 有米，不缺咖啡。 wx: ShenBiXieZuo-Com
- 作者常年接软件外包，python,java,vue全栈
- 人生苦短，我用python。




# 9. 其他内容

# 9.1 软件架构
- 基于pywebview的客户端界面
- vue2前端+flask后端
- 阿里qmax或者kimi的接口
- 不使用mysql，不使用redis，仅安装python，就是所有了
  


-  2024年12月24日 于西三环环普软件园
  (over)