Plugin to summarize event minutes with an LLM

ai_summary/README.md

@@ -0,0 +1,3 @@
+# indico-plugin-ai-summary
+
+This plugin automatically generates summaries of meeting minutes stored in Indico utilizing an open-source Large Language Model (LLM). It enables users to select the minutes they wish to summarize, to choose pre-written prompts or write custom ones to generate the summaries. summary-rebase

ai_summary/indico_ai_summary/__init__.py

@@ -0,0 +1 @@
+

ai_summary/indico_ai_summary/blueprint.py

@@ -0,0 +1,18 @@
+# This file is part of the Indico plugins.
+# Copyright (C) 2002 - 2025 CERN
+#
+# The Indico plugins are free software; you can redistribute
+# them and/or modify them under the terms of the MIT License;
+# see the LICENSE file for more details.
+
+from indico.core.plugins import IndicoPluginBlueprint
+
+from indico_ai_summary.controllers import RHLLMPrompts, RHManageCategoryPrompts, RHSummarizeEvent
+
+
+blueprint = IndicoPluginBlueprint('ai_summary', __name__, url_prefix='/plugin/ai-summary')
+
+blueprint.add_url_rule('!/category/<int:category_id>/manage/prompts', 'manage_category_prompts',
+                       RHManageCategoryPrompts, methods=('GET', 'POST'))
+blueprint.add_url_rule('/llm-prompts/<int:event_id>', 'llm_prompts', RHLLMPrompts, methods=('GET',))
+blueprint.add_url_rule('/summarize-event/<int:event_id>', 'summarize_event', RHSummarizeEvent, methods=('POST',))

ai_summary/indico_ai_summary/client/CategoryManagePrompts.jsx

@@ -0,0 +1,54 @@
+// This file is part of the Indico plugins.
+// Copyright (C) 2002 - 2025 CERN
+//
+// The Indico plugins are free software; you can redistribute
+// them and/or modify them under the terms of the MIT License;
+// see the LICENSE file for more details.
+
+import manageCategoryPrompts from 'indico-url:plugin_ai_summary.manage_category_prompts';
+
+import _ from 'lodash';
+import React from 'react';
+import ReactDOM from 'react-dom';
+import {Form as FinalForm} from 'react-final-form';
+import {Form} from 'semantic-ui-react';
+
+import {indicoAxios} from 'indico/utils/axios';
+import {FinalSubmitButton, handleSubmitError} from 'indico/react/forms';
+
+import {FinalPromptManagerField} from './components/PromptManagerField';
+
+export default function CategoryManagePrompts({categoryId, prompts: predefinedPrompts}) {
+  const onSubmit = async ({prompts}, form) => {
+    try {
+      await indicoAxios.post(manageCategoryPrompts({category_id: categoryId}), {prompts});
+      form.initialize({prompts});
+    } catch (error) {
+      handleSubmitError(error);
+    }
+  };
+
+  const submitBtn = <FinalSubmitButton label="Save Changes" />;
+
+  return (
+    <FinalForm
+      onSubmit={onSubmit}
+      initialValues={{prompts: predefinedPrompts}}
+      initialValuesEqual={_.isEqual}
+      subscription={{}}
+    >
+      {fprops => (
+        <Form onSubmit={fprops.handleSubmit}>
+          <FinalPromptManagerField submitBtn={submitBtn} />
+        </Form>
+      )}
+    </FinalForm>
+  );
+}
+
+window.setupCategoryManagePrompts = function setupCategoryManagePrompts() {
+  const container = document.getElementById('plugin-ai-summary-prompts');
+  const categoryId = parseInt(container.dataset.categoryId, 10);
+  const prompts = JSON.parse(container.dataset.prompts);
+  ReactDOM.render(<CategoryManagePrompts categoryId={categoryId} prompts={prompts} />, container);
+};

ai_summary/indico_ai_summary/client/components/ActionButtons.jsx

@@ -0,0 +1,134 @@
+// This file is part of the Indico plugins.
+// Copyright (C) 2002 - 2025 CERN
+//
+// The Indico plugins are free software; you can redistribute
+// them and/or modify them under the terms of the MIT License;
+// see the LICENSE file for more details.
+
+import React, {useState, useEffect} from 'react';
+import {Button, ButtonGroup, Icon, Popup, Dropdown, DropdownMenu, DropdownItem} from 'semantic-ui-react';
+import {Translate} from '../i18n';
+
+import './ActionButtons.module.scss';
+
+function CopyToClipboardButton({summaryHtml, summaryMarkdown}) {
+  const [isCopied, setIsCopied] = useState(false);
+  const [isDropdownOpen, setIsDropdownOpen] = useState(false);
+
+  useEffect(() => {
+    if (isCopied) {
+      const timer = setTimeout(() => setIsCopied(false), 2000);
+      return () => clearTimeout(timer);
+    }
+  }, [isCopied]);
+
+  function handleCopy(text) {
+    navigator.clipboard.writeText(text);
+    setIsCopied(true);
+  }
+
+  const button = (
+    <Popup
+      trigger={
+        <Button icon styleName="copy-button">
+          <Icon name={isCopied ? 'check' : 'copy'} color={isCopied ? 'green' : undefined} />
+          <Icon name="dropdown" />
+        </Button>
+      }
+      content={isCopied ? Translate.string('Copied!') : Translate.string('Copy summary')}
+      position="top center"
+      disabled={isDropdownOpen}
+    />
+  );
+
+  return (
+    <Dropdown
+      trigger={button}
+      onOpen={() => setIsDropdownOpen(true)}
+      onClose={() => setIsDropdownOpen(false)}
+    >
+      <DropdownMenu>
+        <DropdownItem
+          onClick={() => {
+            handleCopy(summaryHtml);
+          }}
+          icon="code"
+          text={Translate.string('Copy HTML')}
+        />
+        <DropdownItem
+          onClick={() => {
+            handleCopy(summaryMarkdown);
+          }}
+          icon="file alternate outline"
+          text={Translate.string('Copy Markdown')}
+        />
+      </DropdownMenu>
+    </Dropdown>
+  )
+}
+
+function SaveSummaryButton({onSave, saving}) {
+  const [showSavedIcon, setShowSavedIcon] = useState(false);
+  const [prevSaving, setPrevSaving] = useState(false);
+
+  useEffect(() => {
+      if (prevSaving && !saving) {
+          setShowSavedIcon(true);
+          const timer = setTimeout(() => setShowSavedIcon(false), 2000);
+          return () => clearTimeout(timer);
+      }
+      setPrevSaving(saving);
+  }, [saving, prevSaving]);
+
+  return (
+    <Popup
+      trigger={
+        <Button primary={!showSavedIcon} basic={showSavedIcon} icon onClick={onSave} disabled={saving} styleName="save-button">
+          {saving ? (
+            <Icon name="spinner" loading />
+          ) : showSavedIcon ? (
+            <Icon name="check" color="green" />
+          ) : (
+            <Icon name="save" />
+          )}
+        </Button>
+      }
+      content={
+        saving
+          ? Translate.string('Saving summary...')
+          : showSavedIcon
+            ? Translate.string('Saved!')
+            : Translate.string('Save the generated summary to the meeting minutes')
+      }
+      position="top center"
+    />
+  );
+}
+
+export default function ActionButtons({loading, error, summaryHtml, summaryMarkdown, saving, onSave, onRetry}) {
+    if (!loading) {
+        return (
+            <div styleName="action-buttons-container">
+              <ButtonGroup basic>
+                {summaryHtml && !error && (
+                  <CopyToClipboardButton summaryHtml={summaryHtml} summaryMarkdown={summaryMarkdown} />
+                )}
+                <Popup trigger={
+                  <Button icon onClick={onRetry}>
+                    <Icon name="undo" />
+                  </Button>
+                }
+                  content={Translate.string('Retry generating summary')}
+                  position="top center"
+                />
+              </ButtonGroup>
+
+              {summaryHtml && !error && (
+                <SaveSummaryButton onSave={onSave} saving={saving} />
+              )}
+            </div>
+          );
+      }
+
+    return null;
+}

ai_summary/indico_ai_summary/client/components/ActionButtons.module.scss

@@ -0,0 +1,41 @@
+// This file is part of the Indico plugins.
+// Copyright (C) 2002 - 2025 CERN
+//
+// The Indico plugins are free software; you can redistribute
+// them and/or modify them under the terms of the MIT License;
+// see the LICENSE file for more details.
+
+@use 'base/palette' as *;
+
+.action-buttons {
+  display: flex;
+  justify-content: space-between;
+  align-items: baseline;
+
+  .llm-info {
+    color: $dark-gray;
+  }
+}
+
+.action-buttons-container {
+  display: flex;
+  align-items: baseline;
+  gap: 0;
+
+  .copy-button {
+    &:hover {
+      box-shadow: none !important;
+    }
+
+    &:focus {
+      box-shadow: none !important;
+    }
+
+    display: flex;
+    gap: 5px;
+  }
+
+  .save-button {
+    margin-left: 10px;
+  }
+}

ai_summary/indico_ai_summary/client/components/PromptManagerField.jsx

@@ -0,0 +1,124 @@
+// This file is part of the Indico plugins.
+// Copyright (C) 2002 - 2025 CERN
+//
+// The Indico plugins are free software; you can redistribute
+// them and/or modify them under the terms of the MIT License;
+// see the LICENSE file for more details.
+
+import _ from 'lodash';
+import React, {useCallback, useMemo, useState} from 'react';
+import ReactDOM from 'react-dom';
+import {Form, TextArea, Button, Input, Card, Icon} from 'semantic-ui-react';
+import {Translate} from '../i18n';
+
+import {FinalField} from 'indico/react/forms';
+
+import './PromptManagerField.module.scss';
+
+export function FinalPromptManagerField({submitBtn}) {
+  return (
+    <FinalField
+      name="prompts"
+      component={PromptManagerField}
+      submitBtn={submitBtn}
+      isEqual={_.isEqual}
+    />
+  );
+}
+
+export default function PromptManagerField({value, onChange, submitBtn}) {
+  const addPrompt = () => {
+    onChange([...value, {name: '', text: ''}]);
+  };
+
+  const removePrompt = idx => {
+    onChange(value.filter((_, i) => i !== idx));
+  };
+
+  const updatePrompt = (idx, text) => {
+    onChange(value.map((p, i) => (i === idx ? {name: p.name, text} : p)));
+  };
+
+  const updateName = (idx, name) => {
+    onChange(value.map((p, i) => (i === idx ? {name, text: p.text} : p)));
+  };
+
+  return (
+    <>
+      {value.map((prompt, idx) => (
+        <PromptField
+          key={idx}
+          name={prompt.name}
+          text={prompt.text}
+          onRemove={() => removePrompt(idx)}
+          onChangeText={text => updatePrompt(idx, text)}
+          onChangeName={name => updateName(idx, name)}
+        />
+      ))}
+      <div styleName="add-prompt-buttons">
+        <Button icon type="button" labelPosition="right" onClick={addPrompt}>
+            <Translate>Add Prompt</Translate>
+          <Icon name="plus" />
+        </Button>
+        {submitBtn}
+      </div>
+    </>
+  );
+}
+
+function PromptField({name, text, onChangeName, onChangeText, onRemove}) {
+  return (
+    <Card fluid>
+      <Card.Content>
+        <div styleName="delete-prompt-button">
+          <Button icon type="button" compact onClick={onRemove}>
+            <Icon name="trash alternate outline" />
+          </Button>
+        </div>
+        <Form.Field>
+          <Translate as="label">Prompt Name</Translate>
+          <Input
+            value={name}
+            placeholder={Translate.string('e.g. Summarizer...')}
+            onChange={(_, {value: v}) => onChangeName(v)}
+          />
+        </Form.Field>
+        <Form.Field>
+          <Translate as="label">Prompt Text</Translate>
+          <TextArea
+            value={text}
+            placeholder={Translate.string('Enter your prompt here...')}
+            onChange={(_, {value: v}) => onChangeText(v)}
+            rows={10}
+          />
+        </Form.Field>
+      </Card.Content>
+    </Card>
+  );
+}
+
+export function WTFPromptManagerField({fieldId}) {
+  const field = useMemo(() => document.getElementById(`${fieldId}-data`), [fieldId]);
+  const [prompts, setPrompts] = useState(JSON.parse(field.value));
+
+  const onChange = useCallback(
+    v => {
+      field.value = JSON.stringify(v);
+      setPrompts(v);
+      field.dispatchEvent(new Event('change', {bubbles: true}));
+    },
+    [field]
+  );
+
+  return (
+    <div className="ui form">
+      <Form>
+        <PromptManagerField value={prompts} onChange={onChange} />
+      </Form>
+    </div>
+  );
+}
+
+window.setupPromptManagerFieldWidget = function setupPromptManagerFieldWidget({fieldId}) {
+  ReactDOM.render(<WTFPromptManagerField fieldId={fieldId} />, document.getElementById(fieldId));
+};